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t’s the most wonderful time of the year. The time when 


lots of folks see a wild Raspberry Pi appear under the tree 


for the first time. 

And this month we’re all being treated to a brand new 
Raspberry Pi, the super-sweet new 3A+ (page 66). ’Tis the 
season to be jolly and break out the new projects (especially 
ones that need a fast, but energy-efficient small computer). 

If you’re new to Raspberry Pi, then let me be the first to 
welcome you to the party. Grab some cake and help yourself 
to a drink! 

Our Raspberry Pi Superguide (page 28) gives newcomers 
the all-star treatment. In it you’ll find advice on how to 
set up a Raspberry Pi and get started with basic electronic 
components. You’! also learn how to set up simple projects 
like a retro gaming console and home theatre PC. It’s proper 
computing with pins and programming. 

Enjoy the party! 
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Lucy 
Hattersley 


Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangles the piano. 
One day she'll get 
that pet dog. 
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Tide Clock Weather Thing 


rCrumbl smartphone 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 


04 | magpi.cc 


Code a fun game with your 


Pac-Man is back... matrix of switchable lights 


Christmas fun 
with these kits! 
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Code Pac-Man 

Hack smart lights 

Start and stop services 

Pi Bakery: The Matrix part 4 
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SA+ tested! 
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Learn Scratch 


Interview 
This month in Raspberry Pi 
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A A Raspberry Pi and NyBoard 
are used to make decisions 
and control the cat's legs 


Nybble: 
the open-source kitten 


Raspberry Pi robotic cat leaps onto Indiegogo. By Lucy Hattersley 
ack in The MagPi issue 68 (magpi.cc/68) we 
B reported on OpenCat, a Raspberry Pi-based 
project by Chinese roboticist Rongzhong Li. 
Fulfilling his dream to make the project self- 
supported, OpenCat has been renamed Nybble and 
Li has taken it to Indiegogo (magpi.cc/FtXeeb). 
“Nybble is the lightest and fastest robotic cat 
that really walks,” says Li. It’s “not only a robotic 


cat that walks,” he explains, “but a new type 
of pet.” 

The robotic cat has had a complete design 
makeover, and a wooden frame of interlocking 
parts replaces the 3D-printed parts of the 
original. “The wisdom of traditional Chinese 
woodwork was borrowed to make the major 
frame screw-free,” writes Li. 


A The wooden frame is 
designed to be assembled 
without using screws 
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An Arduino-compatible controller called 
NyBoard Vo is used to handle the motion of 
Nybble’s legs. NyBoard sits on top of a Raspberry 
Pi, which controls higher-level functionality, such 
as “perception and decision-making,” says Li. 

The OpenCat software is being developed with 
community support, and you can take a look at it 
on GitHub: magpi.cc/rThMwm. 


Serious cat 

Don’t be fooled by the project’s cute appearance: 
Nybble aims to grab the attention of a serious 
robotics audience. Getting Nybble to walk may not 
be as straightforward as many users imagine, and 


We can break the barrier between 
those million-dollar guadruped 
robots and individual makers 


with eleven servos it should be capable of complex 
movement. Nybble is adorable, but it aims to bea 
“precise instrument”. Users will need to calibrate 
the limbs, for example. 
Li draws comparison between Nybble and 4 aed ae 
high-profile robotics projects like those projects around 
from Boston Dynamics (who build terrifying 
quadrupeds such as Spot and SpotMini). 
“We know that with Nybble, we can break the 
barrier between those million-dollar quadruped 
robots and individual makers,” says Li. “Nybble 
will also be less intimidating to kids who want to 
learn about robotics, programming, and making 
in general.” 

Nybble has met its Indiegogo target, so the 
project is funded and we look forward to seeing 
it in action. 


Nybble hopes to break down the barrier 
between individual makers and million-dollar 
quadruped projects like Boston Dynamics’ Spot 
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P Teachers will get resources, 
training, research, and 
certification as part 
of the programme 


Raspberry P1 


in £78m computing 
education boost 


Dedicated funding for Raspberry Pi to transform Uk 
computing education. By Rosie Hattersley 


get a much-needed jolt of funding with the 
help of the Raspberry Pi Foundation. 
The welcome cash injection comes a year 
after The Royal Society reported that there was a 
‘once-in-a-generation opportunity’ to transform 


C omputing education in England is about to 


M A once-in-d-generation opportunity to 
transform the way computing is taught 
in schools and colleges @ 


the way computing is taught in schools and 
colleges. Commenting on the report, Raspberry Pi 
Foundation CEO Philip Colligan noted that “there’s 
a long way to go before we can say that young 
people are consistently getting the computing 
education they need and deserve in UK schools.” 
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The Raspberry Pi Foundation is one of 
the organisations that, jointly, have secured 
£78 million in UK government funding to 
make this vision a reality. 

The Foundation is part of a consortium 
that also includes STEM Learning and the 
BCS (British Computer Society). Google has 
also pledged £1 million to support free online 
computing and computer science courses 
accessible to anyone. 

While existing computing and ICT 
(information and communications technology) 
teachers are being directly targeted, the scheme 
will also upskill existing teachers in other 
disciplines to teach GCSE Computer Science. 

Philip explains that the money will be used 
“to make sure every child in every school 
in England has access to a world-leading 
computing education.” 


. 
: 


The consortium will found a new National Centre 
for Computing - with a network of computing 
hubs where existing primary and secondary school 
computing teachers in England will be able to take 
part in fully funded CPD (continuing professional 
development) courses. Teachers will also have 
access to free resources enabling them to teach 
computing to students from Key Stage 1 right up 
to A-Level. 

As part of an all-hands-on-deck approach 

to overhauling computing teaching in England, 

the Raspberry Pi Foundation and its consortium 
have more than 60 organisations signed up to offer 
practical assistance and expertise. Businesses, 
universities, and non-profit organisations are 
pooling their expertise and resources to provide 
the support that educators and schools require. 

You can learn more, and get involved, 
at teachcomputing.org. 


A Royal Society report last November 
drew attention to the scale of the 
challenge in transforming the way we 
teach computer science in the UK 


Raspberry Pi in £78m computing education boost 
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Raspbian updated 


New version of Raspberry Pi OS features VLC and Thonny version 3. By Lucy Hattersley 


aspberry Pi has updated Raspbian 

iS alongside its launch of the new Pi 3A+ 
computer. The latest update (2018-11-13) 

introduces major new features, and a host of 

under-the-hood tweaks. 

A new hardware-accelerated version of VLC 
media player enables media playback on the 
Raspberry Pi. It’s been a “glaring omission” 
according to Simon Long, the Software Engineer 
at Raspberry Pi responsible for Raspbian. 

“Windows has Windows Media Player, macOS 
has QuickTime Player and iTunes, but we’ve had 


M@ Major new features, and a host 
of under-the-hood tweaks @ 


8 @ ~2) BB | Th Thonny - shome/pis 


ee 


New Load Run 


receive py * 


import argparse 
import signal 
import sys 
import time 
import logging 


rfdevice = None 


def exithandler(signal, frame): 
rfdevice.cleanup() 
« fay 


A Thonny version 3 introduces Breakpoints 
and a code-analysing Assistant to help 


you debug your programs 


a big hole where something similar ought to be 
for Raspbian,” writes Simon on the Raspberry Pi 
blog (magpi.cc/bavZxx). 

VLC is a powerful piece of software that can play 
(or stream) virtually any video or audio file. “It 


Over | Into Out 


Resume Stop 


Vanables 


segparse 


— 
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A Ahardware-accelerated version of VLC media player enables 
powerful media playback on Raspberry Pi 


uses software codecs for many video formats,” 
reports Simon, and “VideoCore’s video engine 
to accelerate playback of H.264, MPEG-2, and 
VC-1 video.” The software is free, but users will 
need to buy additional licences to play MPEG 
and VC-1 video. 

Thonny, the standard Python IDE 
(integrated development environment) included 
with Raspbian, has been updated to version 3 
(thonny.org). The new edition introduces 
welcome features such as Breakpoints and a 
code-analysing Assistant. 


Recommended software 

Raspberry Pi has chosen to create three OS 
images this time: Raspbian Stretch with Desktop 
and Recommended Software (also known as 
‘Raspbian Full’), Raspbian Stretch with Desktop, 
and Raspbian Stretch Lite (which does not feature 
the desktop interface). 

Raspbian Full includes familiar extra programs 
such as LibreOffice, Scratch, Sonic Pi, Thonny, 
and Mathematica. NOOBS will feature Raspbian 
Full as the default installation. For information 
on using NOOBS to set up a Raspberry Pi, take a 
look at our QuickStart guide (magpi.cc/quickstart). 

Both images are available for download from 
the Raspberry Pi website (rpf.io/downloads). 

To update an existing Raspbian image, open 
a Terminal window and enter: 


sudo apt-get update 
sudo apt-get dist-upgrade 
sudo apt-get install vlc 
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As We Are 


Ever wanted your face to be 14-foot high? Now you can with this sculpture 
covered in LEDs and powered by many, many Pi boards. Rob Zwetsloot 
tries to get his head around it 


Fl Matthew Mohr magine walking through the doors of a the creator, but instead folks around you, or 
& Mac Pierce convention centre and seeing someone’s yourself. Mac opted to use Raspberry Pi boards in 
face staring down at you. Not just in statue the booth after researching the standard solutions. 
Matthew is an artist form, or even on a big TV either — no, this isa “Looking at network-attachable cameras, 
who came up with 14 ft (4.3m) high sculpture of a head, covered in none of the versions we found would work for 
i baie atin LEDs that are hooked up to a load of Raspberry our application,” says Mac. “Either they were 
is the creative Pi boards to display a face. That must be scientific or industrial inspection cameras that 
technologist that somewhat disconcerting. required complex lensing and large mounting 
oa areca “The idea was concepted and artistically requirements — not to mention being prohibitively 
a directed by Matthew Mohr,” Mac Pierce, the expensive — or they had impenetrable APIs and 
7 production manager of the piece, tells us. “It closed software that would limit their usefulness. : 
was commissioned by the Greater Columbus The Pi 3 and Camera Module combo ended up ra] 
Convention Center (columbusconventions.com) fitting nicely for our application, as the camera 
as the centrepiece of their new collection could be mounted separate from the main body 
of local art.” of the Pi, which allowed the overall size of the 
It’s certainly striking. One feature that iseasyto booth to have a lot less wasted space. The Pis 
miss is the Pi-powered photo booth that is inside could also be easily attached to the network, and 


the head, allowing people to get their face scanned = were open so that custom programs could be 
and the images 3D-mapped to the screens. It’s not written on it to handle the photo processing and 
just showing off famous people, or even Matthew network handling.” 
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At night, the head looks out on 
the road to intrigue passers-by 


> There are 29 
Raspberry Pi boards 
in the booth 


> The process is 
similar to texture 
mapping on 


This 14 ft-tall display 3D models 


is made up of a 


series of many LEDs > Creating maps in 


this way takes a lot 
of computing power 


Like any good art piece, this one 
has attracted visitors who would 
like to see and experience it 


OS > The setup 
specifically uses a 


v2 Camera Module 


> The head is built on 
castors which allow 
it to be rotated and 
moved easily 


As We Are | 
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Mac explains, “The overall sculpture 
itself is built around an aluminium frame 
that gives the piece structure and [enables] 
mounting of the LEDs. The LEDs themselves 
were custom-manufactured by Sansi North 


™ One feature that is easy to miss 
is the Pi-powered photo booth 
that is inside the head 


America (snadisplays.com) to be able to 

form the curved layers of the head with only 
minimal faceting. The autonomous system of 
the scanning is done through a series of large 
processing servers, a half-rack of which exists 
in the top of the head, and another full rack that 


” P Atadistance you can 
operates remotely. truly appreciate the 


clarity of the piece 


Close up, you can see all 
the LED banks used to 
create the head image 


A The interior frame 
is built of aluminium 
in slices like this 


<0 These are individual 
LEDs, not just screens 
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While you may be distracted by the head 
sculpture itself, make sure to walk around 
behind it to find a curtain. Walk through it to find 
where the magic happens. 


It takes a lot of Raspberry Pi 
boards to capture enough 
images for the project 


The photo booth part operates via a touchscreen Follow the on-screen instructions to take the 
which guides the users on where to look and how perfect photo (or 30). These pictures are then 
to place their head for an optimal result. The sent to be processed by a server above you, and a 


server elsewhere. 


Raspberry Pi boards then take the photos required 
by the servers. 


See your reaction 

The project has received a fair bit of attention, with 
one person calling it the ‘Ultimate Selfie Machine’, 
and it continues to operate in the Columbus 
Convention Center, where it remains open to the 
public. It even turns around to look out at the 
street at night. 

As for future projects, projection mapping has 
taken Mac’s interest: “I’m right now looking at 

a few different versions of projection-mapping 
software that runs on a Pi, which would make it 
perfect for permanently installed projection pieces. Head back outside and you'll soon see your 
Also, there are a wealth of applications for the Pi face looking back at you. Now's a perfect time 
in digital signage, of which I’m hoping to do some to take a selfie of yourself with yourself. 

projects with soon.” 
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Working Model 
of the Trinity Buoy 
Wharf Lighthouse 


Building ten working models of a lighthouse for your 
wedding day is g hugely impressive feat - Nicola King 
Shines a light on an ambitious project 


Dave 


Dave has a lot of Pi- 
related experience, 
including attaching 
a Pi to his Roomba 
so he could record 
time-lapse videos 
of it hoovering 

the flat. 


magpi.cc/BZVvgm 


Concealed in the 
base are a Pi Zero, 
battery, motor board, 
and LCD; the wiring 
proved challenging 


PA production line of 
lighthouses, ready for 
the big day 


hen Dave knew that he would be getting 
W married in a unique London lighthouse, 

he decided to make some very original 
wedding table centrepieces: working models of the very 
lighthouse in which the nuptials were taking place. Not 
only that, but he resolved to make ten of them — quite 
an undertaking. As Dave explains, “With my love of 3D 
printing, Raspberry Pis, and needlessly complicated 
projects, recreating the lighthouse as a working model 
seemed like the way to go.” 


Buoy oh buoy! 

Over a three- to four-month period, before his 
August 2018 wedding, Dave designed, 3D-printed, and 
completed the models with, unsurprisingly, “the last 
month being pretty non-stop.” 

A time-consuming project, modelling the lighthouse 
necessitated a lot of work, and Dave used many 
photographs of the real-life lighthouse to guide his 
progress. In addition, as he explains, “The software I 
used on the Pi was pretty simple, although I tweaked 
it a few times. The two most challenging parts were 
fitting in all the printing time, and the mechanism for 
the rotating light. I went through a couple of major 
versions of that, a lot of minor versions, and still 
never got it 100% reliable — turns out rotating and 
maintaining a circuit is quite hard!” 
The 3D printing time was indeed considerable, as 
each model required 44 hours of printing in order to 
produce the six key pieces: outer, inner, railing, cap, 
base, and base lid. 
In terms of function, the models include an 18650 
battery (in a shield), a Raspberry Pi, and an LCD display 
in the base. At the top is a warm white LED light on 


16 | magpicc | Working Model of the Trinity Buoy Wharf Lighthouse 


. = = 


Housed in a jam-jar, 
the LED light is rotated 
by a stepper motor 


An LCD display shows 
the table numbers and 


meal status to guests 


| 


| 
| 


only lighthouse 


was designed in 
Autodesk 123D 


Dave used his Prusa 


Mk2.5 to 3D-print 
components 


The body and five other 
parts took 44 hours to 
3D-print for each model 


Dave gave most of the 


models to wedding 


guests - one is now 


in Australia 


top of a stepper motor. “Wires run up the middle 
and when you turn on the battery, it powers on the 
light and the Pi,” reveals Dave. “The Pi then starts 
turning the motor (and light) and displaying various 
messages on the display.” 


Not plain sailing 

Understandably, the project was far from 
straightforward. Dave tells us that he needed to 
tweak the wiring, and there were a number of 
adjustments to the lights. “I ended up with a factory 
line of Raspberry Pis updating themselves and then 
updating their host names on the network when 
they were done - so I could drop onto each one the 
startup script, the display script, and the motor 
script. The display script used a Python scheduler 
and pulled the bespoke messages from a JSON file, 
so I could use the same code and then drop the right 
messages file on each one.” 

Dave’s impressive model-making 
accomplishment was such an ingenious idea, 
and something that was, ultimately, very well 
received by his wedding guests, as he tells us: “I 
didn’t have much trouble giving them away, which 
was great ... one is [now] in the wardroom of a 
navy minesweeper.” 

Dave clearly has a great talent for model-making, 
but tells us that his next model project may be 
something slightly less time-consuming, “T’ll no 
doubt make some other things, but I don’t know 
what yet. I’m looking forward to making only one 
of something.” 
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Trinity Buoy Wharf is 
the site of London's 


The lighthouse model 


Ajam-jar is used for 
the glass light casing 
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®) Sarab is a PhD 
student at Imperial 
College London 
working across 
the Applied 
Mathematics, 


Design Engineering, 


and Tropical 
Forest Ecology 
departments. 


fm magpi.cc/tFdxAg 


Ecosystem 


Monitor 


A team of London-based scientists are using Raspberry 
P| boards and microphones to monitor biodiversity in 
Borneo's forests, David Crookes listens in 


ropical forests are noisy places, the air filled 
with the sounds of a wide diversity of birds 
and animals. They are also rather physically 
taxing thanks to daily thunderstorms, intense 
midday heat, and mountainous terrain. It makes 
it difficult for ecologists to perform manual field 
studies, which are thus prone to a high failure rate. 
So research postgraduate Sarab Sethi — along with 
his supervisors Prof Rob Ewers, Dr Nick Jones, 
and Dr Lorenzo Picanali — have devised a real- 


Attached to a tree by an aluminium rod, the 


monitoring system also contains a deep 


cycle battery and mobile network dongle 


Most components, including the 
Raspberry Pi, are placed within a 
small DRiBOX, with a Rode smartLav+ 
lavalier mic sticking out of one end 


time ecosystem monitoring device based around 
a Raspberry Pi. 

“Our particular interest was in recording audio 
to capture the soundscape — or the combination 
of all the vocalising animals - as this is a rich 
data source that can be used to track birds, 
mammals, frogs, and more,” Sarab tells us. For 
this, the scientists required a device that could 
continuously record, compress, and upload huge 
amounts of data from the field while exploiting 


Solar panels were attached to the top 
of trees by the SEARRP climbing team 
to attract as much sunlight as possible 


P This is the view from 
underneath the solar 
panel, with everything 
firmly strapped or taped 
into place 


> The overall system 
costs £230 to make 


> 64GB can store 
a month of 
animal sounds 


> The Pi boards are 
powered by 20 to 
30W solar panels 


> They're exposed 
to temperatures 
of 2 to 315°C 


> They withstand 
614mm of 
precipitation 
per month 


a patchy mobile signal to remotely transfer data 
to a server. “The Raspberry Pi was ideal as a low- 
cost, relatively low-power device with a usable 
amount of computing power and large support 
for a wide range of sensors,” says Sarab. 


Jungle sounds 

With their field site in Sabah, Borneo, in mind, 
they set about creating a system that could 
monitor the effects of oil palm plantations and 
logging on the region’s biodiversity by listening 
out for the sounds of animals. It involved using 
a Rode smartLav+ microphone to provide high- 
quality audio recordings, along with an external 
USB audio card, solar energy, and a 3G dongle to 
connect to the internet. The ultimate aim is to use 
artificial intelligence to pick up on the audio and 
make sense of the data. 


V The scientists have 
designed the project as a 
general monitoring device: 
new sensor data streams, 
aside from audio, can be 
analysed with a few extra 

lines of code 
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For now, however, the Python-programmed 
software runs two threads concurrently: one 
continuously records data from a sensor and 
stores it in uncompressed files, and the second 
compresses this data and robustly uploads it using 
FTP to aremote server. “It is important that the 
device is networked to minimise the amount of 
times a scientist or research assistant has to go 
to visit the device to manually collect the data - 
freeing up time to be better spent on other more 
efficient and less exhausting tasks,” explains 
Sarab. “Large animals also love to play with (or 
more likely destroy) any equipment left in tropical 
forests. Continuously uploading data serves as an 
instant backup system.” 


Testing times 
The system is being tested at the Stability for 
Altered Forest Ecosystems (SAFE) project in Borneo 
where it’s been up-and-running since February 
2018. It currently uses a network of twelve acoustic 
monitoring devices which are placed across a 
gradient of logging intensity, from old-growth 
untouched forest to oil palm plantations, allowing 
animals to be tracked in specific environments. 
“Our major headache has been the solar power 
system, as the quality and range of batteries 
available in this region of Malaysia is generally 
pretty poor and importing batteries across 
borders is difficult,” Sarab says. “However, the 
monitoring device itself has fared surprisingly 
well, especially considering the near 100 percent 
humidity and regular movement due to shaking 
of trees, animal interference, etc. To date, we have 
collected over 15000 hours of audio using these 
devices, and more is coming in each day.” Hl 
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Project BoxBoom 


This modern take on a retro boombox is sure to (boom) 
shake the room, ds David Crookes discovers 


music back in the 1980s: privately through a 

pair of headphones and a Walkman, or at full 
blast through a portable music player so that other 
people could hear, whether they wanted to or not. 
With Project BoxBoom, Pi enthusiasts and makers 
Dane Hermse and Nicole Horward hope to evoke 
memories of the latter. “When we found a boombox 
in a second-hand store, it instantly made me 
happy,” Dane tells us. “It reminded me of The Fresh 
Prince of Bel-Air and a colourful decade.” 


T here were two main methods of listening to 


Dane Hermse & 
Nicole Horward 


Dane Hermse and 
Nicole Horward 


spend much of 
their spare time 
making fun items, 
from a machine 
that automates 
goodbyes to an loT 
hamster wheel. 
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The pair had wanted to revamp old equipment 
for some time and they soon got to work on their 
new purchase. “The broad strokes of the build were 
already in my head — remove the broken parts, add 
a screen, hook up the audio, run some sort of music 
app, and add a power source,” Dane says. Hoping 
to make use of the old knobs and buttons and have 
them work with a Raspberry Pi while retaining the 
old look and feel of the original player, he envisioned 
that a touchscreen would replace the cassette deck. 


Sounds good 

After opening the old boombox, the pair first checked 
which components still worked and they looked for 
parts that could be reused. “We found everything 
was broken except for the speakers, so I went looking 
for the parts we needed,” says Dane. “This meant 
measuring what screen would fit, how much power 


™ When we found a boombox in a second- 
hand store, it instantly made me happy @ 


the amplifier would need, and how big the power 
bank could be. I was also keen to ensure the inside 
mechanics would keep working and the outside 
stayed nice.” 

Aside from a Raspberry Pi 3 Model B, Dane 
ordered an Adafruit HDMI 5-inch 800~480 display 
backpack with a resistive touchscreen, along with 
an Adafruit TPA2012 2.1W stereo audio amplifier, 
and a 2.4A power bank. He cleaned up the hole 
where the cassette player used to be at the front of 
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A The screen is ready to be installed. Dane says the GPIO pins 
could be connected to control LEDs, too 


the boombox, and 3D-printed two frames to hold 
the screen. 

“Next, I soldered the amplifier chip, connected 
the speakers to the amplifier, added the Raspberry 
Pi, and hooked up the wires,” Dane explains. Here 
the Pi came into its own. “Its in-built internet 
connectivity, four USB ports, audio jack, and HDMI 
port were super-useful,” he continues. “But then 
for every project we do, the Pi is a default: you can 
do anything with them.” 


Streaming ahead 
Getting a web music player to co-operate was 
trickier. “Spotify didn’t work on Chromium, which 
was something to do with Widevine digital rights 
management, but Deezer worked on the first try,” 
Dane says, explaining that SoundCloud also worked. 
“Adding an on-screen keyboard extension to the 
browser meant the boombox was ready to be used.” 
For the finishing touches, Dane converted the 
old antenna into a touchscreen stylus, painted 
the screen frames black, cleaned the entire build, 
and put the old screws back. “The most difficult 
part was to make it look nice,” he muses. “But it’s 
had very positive responses.” Music to his (and 
everyone else’s) ears, we’d suspect. H 


PROJECT SHOWCASE |\ifagri 


It can play for up 
to six hours 


It took around 20 
hours to build 


The display frame 
was designed in 


Tinkercad 


It was 3D-printed on 
an Original Prusa i3 


The original 


boombox speakers 


were used 


Dane added a startup 
script that opens the 
browser on the Deezer 
homepage in full-screen 


All of the components, 

including the Pi and the 

power bank, are neatly 

sealed within the case i” KER SYST! Having no prior experience with 
audio equipment, Dane sought 
help online to eliminate humming 
noises from the speakers 
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Fin 
Hopkins 


A software engineer 
on the City of 
Boston's Digital 
Team, Fin is into 
board games, web 
development, and 
social justice. 


magpi.cc/ZOSXTQ 


Tide Clock 
Weather Thing 


This beautifully crafted device provides a detailed weather 
forecast dnd low tide times. Phil King is on cloud nine 


after the kids in Maine over the summer, 
Fin Hopkins decided to build a ‘Tide Clock 
Weather Thing’ to help predict the weather and 
tides for days out at the beach or kayaking. 
“T remember [the reaction from the recipients] 
was something like ‘wow, that’s beautiful! What 


S eeking to make a gift for the in-laws looking 


M| had to point out what all the lights 
and dials were, since there aren't 
any markings on the case @ 


is it?’ I had to point out what all the lights and 
dials were, since there aren’t any markings on 
the case,” recalls Fin. 


How it works 
The large wheel on the device shows the current 
weather conditions on top; as they change, it 
rotates planetary gears to bring a new icon to the 
top. In the middle of the wheel, a finger points to 
the current temperature, with the forecasted daily 
range lit by coloured LEDs. Five more LEDs below 
light up blue for impending rain, filling up to show 
when it’s 60, 45, 30, 15, or 5 minutes away. 

24 LEDs at the bottom of the device represent 
each hour of the day, lighting up in different 
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<4) Assembling the 
laser-cut hub and 
planetary gears, 
which are rotated by 
a stepper motor 


HK APi Zero runs the 
code, a Speaker 
PHAT provides chime 
sounds, while a 
Trinket Mo controls 
the NeoPixels 


colours for forecast weather conditions — including 
blue for rain, yellow for sunny, dim white for 
cloudy, and green for windy. Just above this strip, 
a moving bar with two pointers shows when the 
two daily low tides will occur. 

A chime is also sounded for low and high tides 
using a Speaker pHAT connected to a Pi Zero, 
which runs the Python software and controls the 
NeoPixel LEDs via a Trinket Mo microcontroller. All 
the weather data is sourced from the Dark Sky API, 
while tide data comes from the NOAA’s Tides and 
Currents site. 


Time to make 

From the first gear prototypes to a working version 
of the device took Fin about three weeks, working 
nights and weekends. “We were going to visit my 
in-laws for the 4 July holiday, so it was a sprint to 
a tight deadline at the end. I got all the hardware 
and wiring done, and then ended up finishing the 
coding while I was up there.” 

The design adapted and fell into place as Fin 
prototyped, starting with the laser-cut planetary 
gears — for the weather symbols — which rotate 
around a central hub. “Once I saw how neat the 
large version [of the wheel] looked, it was ‘OK, 
what else can I put with this?” 

A lot of the changes made concerned reducing 
the scope. “I wanted to show high and low tides 
over two days, with each indicator separately 


— * FF 
j 
PREYECT SyOWCASE | MagPi 


Quick FACTS 


> It's made from 
medium cherry and 
maple plywood 


> The large wheel 
rotates 360° at the 
top of every hour 


= 


The weather 
icons (designed 
By ust >» ANeoPixel ring 

Condiff, CC BY) ji 

- j ; _ a as aS > . ere provides the 

= — : ‘ - = ae i are printed on LED arcs 
i. : fee = - 7 planetary gears 
. Sas : 3 ae that rotate as 


> The laser-cut parts 
they move 


} f = = Se <I = A A I y were designed 
J it Se - - = : 2 / Ja i ‘ in Inkscape 
= , ithe ) 


| » Finis working on an 
- edge-lit acrylic sign 


The finger points to the current 
temperature, while lit LEDs show 
the daily range in 5°F increments 


A micro-servo and gears move 
two pointers along to indicate 
times for the day’s low tides 


controlled. Once I got into ‘OK, now how would 
I build that®’ it became one day, then not 
separately controlled, then just low tides,” 
explains Fin. “Even after I simplified my goal for 
the tide indicator, it took a number of prototypes 
to get right.” 
Making their debut Raspberry Pi - and electronics 
— project was an educational process for Fin. “I 
learned how to solder, how to crimp wire, and I 
finally got my head around the difference between 
voltage and current. I learned about stepper motors, 
GPIO pins, I?C communication, PWM, and a ton of 
other topics.” 


qa top-down view of the 
project, showing how all 
the laser-cut and electronic 
parts fit together 
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rCrumbl 


Sometimes things don't always go to plan, but that's 
the way the cookie crumbles. David Crookes talks to 
Dylan Radcliffe about his attempt to create a 3G phone 


Dylan Radcliffe 


As well as getting 

his hands dirty asa 
keen maker, Dylan 
loves the great 
outdoors and he's 
passionate about the 
environment, hiking, 
food, and gardening. 


magpi.cc/iTVuOC 


ack in 1982, everyone’s favourite extra- 
B terrestrial, E.T., needed to phone home, so an 

attempt was made, via a coffee can filled with 
electronics connected to a tinfoil-lined umbrella, and 
a Speak & Spell. For many of today’s modern makers, 
that would be an alien concept (not least because it 
just wouldn’t work). But it’s one Dylan Radcliffe may 
well have paid some thought to, given his struggles to 
create a 3G smartphone based around a Raspberry Pi. 

Usually our project showcases highlight the finished 

product, but in this case Dylan needs some help. 
When he began planning his project, he based it on 
the TyTelli DIY smartphone, a device made almost 
four years ago by Tyler Spadgenske that could snap 
photos, send texts, and make and receive calls. It used 
a specially written OS in Python and it was housed in 
a 3D-printed case. But it only worked on a 2G cellular 
network and Dylan found, to his horror, that his home 
country of Canada had finally phased it out. 


2G or not 2G 

“1d purchased a PCB which was only designed to work 
with a 2G network, but I was lucky because the supplier 
had also released a 3G chip,” he says. “Unfortunately, 
all of the software produced by others for their 

phones wor’t work with this new chip, so this is my 


M His primary aim of creating a Pi-based 


phone that 


could fit into his pocket has 


been a success @ 
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challenge.” So far, he’s been able to call his landline 
using the command line, but he is vowing to do better 
and he hopes readers of The MagPi will be able to help. 
As it stands, Dylan has a functional pocket computer 
running Linux, but it remains a great example of 
determination. His primary aim of creating a Pi-based 
phone that could fit into his pocket has been a success, 
and that has been down to a great deal of time spent 
determining exactly how everything would need to be 
wired together in order to create a functional piece 
of electronics. 


The rCrumbl's software is a 
modified version of Raspbian 
with a GUI overlay called 
TYOS (magpi.cc/OenLan) 


The build includes a Raspberry Pi B+ together with 
an Adafruit 3G GSM, an Adafruit Pi 3.5-inch TFT, 
and the Pi Camera Module v2.1. It also features an 
Adafruit PowerBoost 500 Basic charger, a 2500 mAh 
lithium-ion battery, a mini metal speaker, an 
Adafruit Electret microphone, and a rugged metal 
on-and-off switch. 


Wiring up 

Most of the connections on the breakout board are 
wired directly to the GPIO pins on the Raspberry 

Pi. “Charging the phone and most of the power 
requirements are handled by the Adafruit FONA 
modem, which has a built-in mini USB plug and 
provided GPS,” Dylan reveals. “This does leave the 
phone at a disadvantage, though, because powering 
off the phone needs to be done via software before 
hitting the power button.” 

To get everything to fit, Dylan spent a lot of 
time with a pair of callipers measuring distances 
between components and wires. “Once I had 
everything working, I created a small box on my 3D 
printer and tried to cram everything in, in a way 
that made sense,” he says, knowing that he would 
end up soldering in the tightest environment he’d 
ever experienced. 

He then spent a couple hours thinking about how 
to optimise the design and writing notes before 
firing up his CAD software again. In the process, a 
small bracket was designed and used to attach some 
of the smaller PCBs to hold them in place. “All I 
have to do is get 3G working, but I’m sure I'll get 
there in the end,” discloses Dylan. Hl 


Dylan says he 

learned much about 

product design, > rCrumbl is short for 
CAD, and 3D printing Raspberry Crumble 
through his project 


> Dylan wants to run 
it on a 3G network 


> It makes calls via 
the command line 


> 30 different cases 
were created 
and tested 


> It can run for up to 
twelve hours 


= 


A set of four buttons 
has been added at the 
bottom of the screen for 
greater usability 


> No smartphone is complete 
without the ability to snap a 
selfie, hence the use of the Pi 
Camera Module v2.1 


A Packing everything into 
the case was a squeeze 
and it entailed some 
tight soldering 
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SUBSCRIBE TODAY 
FROM ONLY £5 


UPTOSY /o 


OFFICIAL 


>» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 
Great gifts, offers, and discounts 


» Great Savings 
Save up to 35% compared to stores 


» Low Monthly Cost (from £5) 
» Cancel at any time 

)» Free delivery to your door 
» Available worldwide 


£55 (UK) £90 (USA) 
£80 (EU) £95 (Rest of World) 


Free Raspberry Pi 3A+ with 12 Month upfront subscription only 
(no Raspberry Pi 3A+ with Rolling Monthly Subscription) 


© Subscribe online: magpi.cc/subscribe 
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This is a limited offer. It replaces our usual offer of a free Pi Zero W. 
Offer subject to change or withdrawal at any time. 
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ee eee Available on the 
cara a 
Le 
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THE RASPBERRY PI 


SUPERGUIDE | 


Everything you need to know to get started 
with Raspberry Pi — updated for 2019! 


elcome to our ultimate guide for 
W the Raspberry Pi! There’s always new 

Raspberry Pi software and hardware 
coming out and while we like to think we keep you 
updated on it all, it does mean that our complete 
guides can sometimes feel a little outdated. 

That’s why we’ve put together this: a completely 
new guide to getting started. If you are (or 
someone you know is) new to the Raspberry Pi, 
this guide has you covered. 

So, whether you have an original Model B ora 
brand-new 3A+, get ready to enter the world of 
Raspberry Pi. It’s a lot of fun! H 


QUICKSTART 
GUIDE sy) 


Get your Raspberry Pi working 


Got your Raspberry Pi but still not sure how perry Pi 
to even get it turned on? It’s very simple - Bajokstart Guidg 4 
you just need to download an operating ee = 
system from the Raspberry Pi website : 
(magpi.cc/noobs), put it on a microSD 
card, and plug it in. 

Let us guide you through 
this process step-by-step in our 
QuickStart guide, which you can 
download here: magpi.cc/quickstart 
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MaigPi 


OFFICIAL 


Want some more ideas of 
how to use your Raspberry 
Pi? Head online... 


Hundreds of projects from 
the Raspberry Pi Foundation, 
Code Club, and CoderDojo 
can be found here, covering 
a wide array of programming 
and electronics projects. A 
lot of them are suitable for 
younger makers as well! 


If you need some in-depth 
info about your Raspberry 
Pi and Raspbian, the 
official documentation is 
very thorough and even 
contains examples to 

help you understand what 
everything means. 


The Raspberry Pi community 
can be found on the official 
forums, and they have plenty 
of expertise with using the Pi. 
You'll usually be able to find 
a solution to any issues you 
have here - and if not, you 
can always ask about it. 
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WELCOME TO THE 


New to the world of Raspberry Pi? PJ Evans shows you around 


magpi.cc 


nce you’ve got Raspbian 

with Desktop and 

Recommended Software 
installed and running, you may be 
wondering what to do next. Let’s 
look at some of the key software 
installed, how to add more, and 
some of the differences between 
Raspbian and its peers, Windows 
and macOS. 


Web browser 

An open-source version of Google 
Chrome, Chromium is a fast 

and fully-featured web browser 
that can handle the demands of 
modern websites. 


The RaspberhRiSEperauice 


Office suite 

Word processing, spreadsheets, 
presentations, databases, and 
drawing. A complete suite of office 
tools free with your Raspberry Pi. 
Compatible with other packages 
such as Microsoft Office. 


MagPi Rocks! 


Command-line access 

The gateway to thousands of 
powerful text-based applications 
and tools, you may find yourself 
using the Terminal a lot to run 
scripts or install software. 


Fun programming environments 
Scratch is the perfect introduction 
to coding. You can build games 
or even control lights using the 
Pi's GPIO pins. Its graphical block 
system makes coding friendly. 


Open-world game 

Not only can you run Minecraft on a 
Pi, you can learn by interacting with 
its virtual world through code. The 
only limit is your imagination. 


JOO]SIOMZ Goy “PAID 


SONIC PI 

Music generation 

Known as ‘live coding’, creating 
music through code has been 
thrust into the mainstream by this 
phenomenal application. Your 
Raspberry Pi is now a serious 
musical instrument! 


VLC 

Media player 

The Swiss Army knife of media 
playback, supporting a multitude of 
video and audio formats. If it can be 
played, VLC will probably be able 
to play it. 


CLAWS MAIL 


Email client 

If you need more than webmail, 
Claws provides all the common 
features you'll need. It's easy 

to configure and provides an 
elegant interface. 


01 Open your 
package 
manager 
The most straightforward 
way to install software on 
Raspbian with Desktop is 
to use the ‘Add/Remove 
Software’ application. Start 
by clicking the Raspberry Pi 
logo to open the menu, then 
select ‘Preferences’ followed 
by ‘Add/Remove Software’. 


Get searching 
We’re going to install 
GIMP, so it’s as simple as 
entering ‘gimp’ in the search 
box and pressing RETURN. 
After a few seconds, a list of 
matches appears. Click the 
one just labelled ‘GNU Image 
Manipulation Program’. Any 
other required packages, 
known as dependencies, will 
automatically be installed. 


Install 

Now the good bit. 
Click ‘Apply’. You will need 
to enter your password. 

Your application will 

then be downloaded and 
installed for you. Installation 
time will depend on your 
bandwidth and the size of 
the package in question. 
GIMP typically takes a couple 
of minutes to install. Once 
complete, you can find GIMP 
in the application menu 
under ‘Graphics’. 
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@ Programming > 


% Office > 


@ Internet > 
Fr 7 Games > 


= 5 Accessories > 


i) Graphics > 
sb Sound & Video > 


ees) Help > 


a Add / Remove Software 


e4-,, Appearance Settings 
re Audio Device Settings 
; A Main Menu Editor 

ie:| Mouse and Keyboard Settings 
& Raspberry Pi Configuration 


& Recommended Software 


@ Accessories 
1D agmin tools 
Communication 


& Fonts 


Tl Other 
@ Programming 
BB Puviishing 


ten 


col e 
the ones you might find in Photoshop. Numerous fine-control 
=) Science ~ Settings and features like layers. paths, masks, and scripting give you ~ Cancel Apply OK 


BBD Localisation 
BY Muttimedia 
Network 


GIMP is an advanced picture editor. You can use it to edit, enhance, and 
ay 

Wg tools and filters, 

hop. Numerous fine-control 

ks. and scripting give you 
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CODE HELLO WORLD | SWITCH TO RASPBIAN 


01] Start Thonny 


The Raspberry Pi is designed to make 
it easy to learn to program a computer. 
There are lots of 


: 8 Oc 
programming Programening Hy AB sive! Java IDE i 
languages, but the |@® 2 ee err ma 
best one to start with @ vw te 
is Python. Youcanuse fi » Bre 
Python onaRaspberry = # 

Pi using a program Bo Ace » By soe 
called Thonny. From Bree Bs 

the applicationmenu, "ww 8 i. them Pyten be 
select Programming > 8 


Thonny Python IDE. = 


Hello World ca cas 0 
It’s traditional 

for any new program in 

a language to display / 

Hello World on the 

screen. Click on the 

main screen in Thonny 

and enter: 


print("Hello World") 


Click Save and call your program hello_world.py. 


Run your code 

Click on the green Run button. 
Congratulations! You’ve just run your first computer 
program. Python is a very easy language to learn. 
Visit magpi.cc/learnpython to read our starter guide. 


Thoni vid py @ 1°21 


tae nOBBesb oo me 


nt ("Hello World") 
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aspbian is the name for 
FR the Raspberry Pi’s official 

operating system andit’sa 
Linux distribution. ‘Raspbian with 
Desktop’ comes with a graphical 
user interface. Here are some key 
differences between the Desktop 
and other systems. 


fi (- 

®OG 
APPLICATION MENU 
The application launch menu 
operates in a similar way to Windows, 
but is located at the top. Clicking the 
Raspberry Pi logo (top left) displays 
the menus where you can find pre- 
installed software and access to 
various utilities. Favourite apps can be 
pinned on the left and some utilities 
can be controlled on the right. 


. 
TERMINAL CONFUSION 


Chances are, you'll use the Terminala 
lot to run scripts and issue commands 
to the operating system. This 
command-line interface is common 
to all operating systems, but often 
goes by different names. ‘Command 
Prompt’ (Windows), ‘Console’, and 
‘Terminal all refer to the same thing. 
Learn more at magpi.cc/terminal. 


DIRECTORY LAYOUT 

All users on Raspbian have a 
home directory in /home. Just like 
Windows and macO§, you'll see 
directories such as ‘Music’ and 
‘Pictures’ already created for you. 


FILE MANAGER 
Like other operating systems, you can 
graphically browse the file system. 


Your default user is ‘pi’ and your 
home directory is /home/pi. Don't 
worry about looking around but if 
you're asked for a password before 
changing a file, the system might be 
trying to protect it, so take care. 


REMOTE CONTROL 

Want to get remote control of your 
Pi? Windows has ‘Remote Desktop’, 
macOS has ‘Back to my Mac’, and 
Raspbian has VNC. A server is 
installed by default but not active. 
Enable it in Preferences > Raspberry 
Pi Configuration > Interfaces. 


SSH 

If you just need remote command-line 
access to your Pi, SSH can be enabled 
to provide a ‘Secure Shell: This can be 
accessed from other Pi boards, Linux 
distributions or macOS using Terminal, 
or the PUTTY app for Windows. 


WASTEBASKET 

While macOS has ‘Trash’ and 
Windows has a ‘Recycle Bin’, the 
Raspberry Pi has the ‘Wastebasket: 
It works in exactly the same way. 


¥ Tl @)) [ 75)%e| 17:35 


WHAT'S WITH 

THE PERCENTAGES? 

If you're scratching your head over 
the bar graph placed in the top- 
right, it’s a live reading of the CPU's 
activity. If things appear slow and 
the percentage is high, it may be 
the machine is ‘having a think’ or too 
many tasks are running. 


ACCESSORIES 

The Accessories menu provides 
applications for many common tasks. 
Both Image Viewer (in the Graphics 
menu) and PDF Viewer have the 
functionality of macOS's Preview. 
There's also a Task Manager which, 
like Windows (or Activity Monitor in 
macOS), allows you to track what's 
going on with your machine. 


FEATURE | Mag?t 


EWN 


RASPBERRY PI AND THE 


the Raspberry Pi from the average 

desktop PC or laptop is its GPIO 
(general-purpose input/output) header. 
This collection of pins on the edge of the 


PHYSICAL 


Take your coding further 
and break out of the 
screen into the real world 


T he one piece of hardware that separates 


board provides a simple, safe way to connect 
circuits to the Pi so it can interact with 

its surroundings. From blinking a light to 
controlling a home security system, it’s the 
GPIO that makes it all possible. 


ELECTRONICS COMPONENTS AND KIT 


BREADBOARD 

> magpi.cc/tswiyk 

An easy way to connect components together 
and to the Pi itself. Cheap, easy to use, and 
essential for prototyping your next masterwork. 


JUMPER WIRES 

> magpi.cc/ecmNPS 

Jumper wires are used to make connections on 
the breadboard and to the Raspberry Pi's GPIO 
pins. Look out for multipacks containing different 
lengths and types. 


LEDS 

> magpi.cc/gqdVMP 

Add some colour to your project with light- 
emitting diodes. Inexpensive and a fun 
component for your first projects. Available 
in multiple colours. 


TACTILE BUTTONS 

> magpi.cc/aCtkRt 

The GPIO handles input as well as output, so a 
great way to learn is with a tactile button. These 
fit straight on to breadboards for easy building. 


BUZZERS 

> magpi.cc/ijcKzz 
Make some noise! Simple buzzers come in 
a wide variety of types and sizes, and are 
straightforward to add to projects. 


RELAYS 

> magpi.cc/nRidMi 
Want to switch something on but not be 
connected directly to its circuit? Relays are 
a simple solution where you don't ‘cross 
the streams’ 


STRIPBOARD 

> magpi.ce/mirhkq 

A cheap alternative to custom PCBs 
for small circuits. Strips (or pads) of 
copper on a board on to which you can 
solder components. 


SOLDERING IRON 
> magpi.cc/gnxPQs 

If you want to transfer a breadboarded circuit 
to a PCB or stripboard, you'll need a soldering 
iron, a stand, and some lead-free solder. 


ri 
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hen you first learn 

to code, chances are 

you’ll write a program 
to display ‘Hello, World!’ on 
the screen. 

When learning electronics, 

you'll make something light up. 
No exceptions here! Let’s see 
how, with just a few lines of code, 
the GPIO can light up your life. 


Insert the LED into 
the breadboard 
As one of the LED’s legs is 
longer than the other, you may 


The resistor ‘squeezes’ the 
current to make it safe for 
the Pi and LED alike 


need to bend it (carefully!) so 
both legs will fit securely in 

the breadboard. LEDs will only 
work one way round in a circuit, 
so the longer leg indicates the 
positive side. 


Add a resistor 

An LED will attempt 
to draw more current than 
a Raspberry Pi can handle, 
potentially damaging the LED or 
even the Pi. To prevent this, we 
must add a resistor which will 
limit the flow of electricity to 
safe levels. Place a 330Q resistor 
so it connects with the negative 
(shorter) leg of the LED. 


Wire to the Pi 

Orientate the Piso the 
Ethernet and USB ports are at the 
bottom (six o’clock). Now pin 1 
of the GPIO is the top pin on the 
eft. GPIO17 is the sixth pin down 
on the left. Connect a jumper 
cable to this pin and then to the 
positive leg of the LED (via a hole 
in the same breadboard column). 


Grounding 

Finally, for the current to 
flow, it needs a ground. Connect 
another jumper cable to one of 
the GND pins of the GPIO. There’s 
one directly above GPIO17. This 
connects to the other side of the 
resistor (again, via a breadboard 
hole in the same column). 


Code 

We'll use Python with the 
GPIO Zero library to control the 
LED. Under ‘Programming’ in 
the main menu, open ‘Thonny 
Python IDE’ and enter the 
code below exactly as shown, 
including the indentations. Then 
click ‘Run’ to see the LED blink. 


t Extend Python's capabiliti 


gpiozero 
time 


# Set 'red' to represent the 


red LED(17) 


Loop forever 


This provides current 
to the LED that we can 
switch on and off in code 


ee) 
sleep(1) 


Stop the current 


red.off() 
sleep(1) 


et’s add some input to 

our new circuit. We’ll add 

a push-button that can 
control the LED. 


Orientate 

the button 
Start by placing your push- 
button in the breadboard, being 
careful not to interfere with the 
LED circuit. The button has four 
pins which protrude on two sides. 


The pins opposite each other 

are always connected, so the 
protruding sides needs to ‘bridge’ 
the lines of the breadboard. 


Connect to the GPIO 
We need to connect 
the button to the GPIO so we 
can monitor its state. We’ll 
use GP1O18 for this, which is 
the pin directly to the right of 
GP1IO17, the one we used in the 


Be careful which way round you place 
the push-button. There should only 
be one ‘space’ between the legs on 


the breadboard 

eeeeses: eee 
eeee#s eeeeeee%ees?ss+ 
eeees#ses? eeeeeesesserfses?ss# 
eeeees? i ye eeeeeenekste?s se? 
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° Jj « 0 ie eee ole eicd different 
COFFE ORCEG eo eee? GPIO pins, so the two 
eee? e064 a 2 ae circuits are isolated 
e e ej; e eeees 


LED circuit. Now connect the 
other end of the jumper cable 
to either of the button’s legs 

on the breadboard. 


Ground the button 

Just like the LED, we 
need to ground the button so 
current will flow. There is a 
spare ground point directly 
below GPIO18. Connect this to 
the other leg on the short side 
of the button. Before switching 
anything on, check and check 
again that the GPIO is wired 
up correctly. 


More code 

Just like before, enter the 
code below into Thonny and click 
‘Run’. Now, when the button is 
pressed, the LED will light up. 
What else can you make it do? 


gpiozero 


signal pause 
# Assign these variables to 
led = LED(17) 
button = Button(18) 


# Assign events that are tr 
button.when_pressed 
button.when_released 


command preve ¢ Python 
Ss command prevents Pytho 


Base 
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led.on 
led.off 


MéigPi 


ELECTRONICS 


crIoZERO 


" Raspberry Pi 


Get up-and-running 
with electronics 
quickly with our GPIO 
Zero Essentials Guide. 
magpi.cc/gpio-zero 


LED, Button 
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COMMAND-LINE 
SUPER BASICS 


OL 


CONQUER 
4 COMMAND 


The command line is a powerful 
and efficient way to interact with 
your Raspberry Pi 


he Terminal application 
T is your gateway to the 

Raspbian command line. 
Yes, having a black screen with 
a flashing cursor and little else 
may seem a little intimidating, 
but with practice the command 
line becomes a go-to 
environment for getting things 
done. Click the Terminal icon in 
the Task Bar to start.. 


pi@raspberrypi: ~ 


File Edit Tabs Help 


COMMANDS 


sudo 

‘Super/substitute user do’. 

Some commands require extra 
privileges to work. Prefixing the 
command with ‘sudo’ allows 
this. If you forget, type sudo !! 
to repeat the previous command. 


sudo raspi-config 


apt 

APT is Raspbian’s package 
manager. It can be used to install 
a huge range of applications and 


MAGPI vine ; 
ESSENTIALS also keeps existing installations 
CONQUER THE up to date. 


COMMAND LINE 


Master your computer 


sudo apt install gimp 


using command-line 


code in Terminal with 
our free guide. 


magpi.cc/ 


essentials-bash 


cd directory path 
Raspbian stores files in 
directories. ‘cd’ is short 
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for ‘change directory’, so 

cd /boot will take you to the 

Pi’s boot directory. cd on its 

own always takes you to your 
home directory. 


cd /home/pi/MagPi 


1s directory 

View the contents of a directory 
(list). If you omit the directory, 
the current one will be listed. 
Add -1 before the directory for 
a more detailed output. 


1s -1 /boot 


cp, mv, and rm 

‘Copy, move, and remove’. These 
are used to make copies of files 
or directories, move files around, 
rename or delete them. cp 


takes two arguments: source 
and destination. 


cp /home/pi/MagPi/MagPi75. 
pdf /home/pi/Desktop/ 
MagPi75.pdf 


mkdir and rmdir 
Make and remove directories. 
You can have as many as you 
like, and have directories 
within directories. 

Tip: To create multiple levels 
in one command, use -p. 


mkdir -p /home/pi/my/new/ 
directory/tree 


exit 

When you’re done in the 
Terminal, simple type exit to 
cleanly close everything down. 


APT 


Advanced Package Tool. This 
is the Raspbian package 
manager for installing and 
upgrading applications. 


ARM 


Designer of the Raspberry Pi’s 
processor architecture. 


Broadcom 


Manufacturer of the Raspberry Pi’s 
main processor. 


Burn 


The process of writing an operating 
system image to an SD card. 


Distribution 


The many versions of Linux, 
including Raspbian, are known 
as Linux distributions. 


DSI 


Digital Serial Interface. The DSI 
connector on the Raspberry Pi can 
be used to connect displays. 


Ethernet 


A wired networking system. 


GPIO 


General-purpose input/output. 
An array of pins for connecting 
physical circuits to the Pi. 


GPIO Zero 


A Python library of tools for 
communicating via the GPIO. 


BUSTER 


Worried about your boot? Pip got you pipped? Here are some of 
the more common terms you'll hear in the Raspberry Pi universe 


GPU 


Graphics processing unit. On the 
Pi, this assists the main processor 
to provide smooth, fast graphics. 


HDMI 


All Raspberry Pi models provide an 
HDMI output to connect to modern 
televisions and monitors. 


IC 


Inter-Integrated Circuit. Like 
SPI, allows multiple devices to be 
connected to the Pi via the GPIO. 


Kernel 


A small piece of code that is the heart 
of the operating system. Everything 
runs ‘on top’ of the kernel. 


Linux 


A family of open-source operating 
systems, including Raspbian. 


os 


Operating system — the code that 
handles the interaction between 
the processor, its devices, and the 
outside world. 


Packages 


Distributions of applications that 
are handled by APT. 


pip 
A package manager for Python to 


ease the installation of Python 
libraries and other applications. 


Prompt 


As in ‘prompt for input’. The 
S symbol before your cursor in 
the Terminal. 


Raspbian 


The official operating system of the 
Raspberry Pi. 


SoC 


‘System on a Chip’. The main 
processor on the Raspberry Pi 
handles many functions of a 

computer in a single package. 


SPI 


Serial Peripheral Interface. A way 
for devices to communicate. The 
GPIO features an SPI interface. 


SSH 


“Secure Shell’. A way of accessing 
acommand-line interface ona 
remote computer. 


sudo 


‘Super/substitute user do’. Run 
a command with the highest- 
possible privileges. 


Terminal 


A program that gives access to the 
Raspbian command-line interface. 


UART 


‘Universal asynchronous receiver- 
transmitter’. A very simple way for 
computers to communicate. 


MéigPi 


MégPi 


LASY 


Discover a range of easy-to- 
build media player projects in 


Build something small and useful with your Raspberry Pi The MagPi #66: magpi.cc/66 


fter setting up your Raspberry Pi and learning about 

all its features, the first thing you’ ll want to do is 

to build something useful. Nothing helps you learn 
like a project, and the Raspberry Pi can become all kinds 
of different things. We’ve picked three simple and fun 
projects to help you get started. 


HOME THEATRE 


Install LibreELEC 


Kodi is our favourite 


perDEEy = media centre software. With Kodi 
(any model) : 
; you can play your own movie and 
pOEeELEY music files. Kodi is available on 
paDRECIEe EY) the Raspberry Pi in a range of Copy movies 
HDMI cable different operating systems. The across 
Power supply best in our eyes is LibreELEC, With Samba enabled, you can 
(magpi.cc/power) available in NOOBS (New Out copy video files from a Windows 
Remote control Of Box Software). Follow our PC to your Raspberry Pi pretty 
(magpi.cc/cxudSB) Raspberry Pi QuickStart guide easily. Open a File Explorer 
(magpi.cc/quickstart), but window in Windows, and click 
choose LibreELEC instead of Set up Kodi on Network in the Navigation 
Raspbian in Step 5. LibreELEC will boot up pane; double-click LIBREELEC. 
into the Kodi interface. For Drag and drop movie files to the 
the setup process, it is useful Videos folder (and likewise for 
to plug a keyboard into your Music, TV Shows, and Pictures). 
Raspberry Pi (although you Use Kodi to select the video and 
can use Kodi just fine with a start playing it. 


remote control). Go through the 
Welcome process and connect to 
your local wireless LAN network 
(or use an Ethernet cable). 
Samba remote access should be 
activated by default; ensure it’s 
set to on. Use SSH and take note 
of the IP address if you’re using 
a Mac. 
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RetroPie 

Turning a Raspberry Pi 
into aretro games console is 
another easy (and fun) project. 
It’s incredibly easy and good 
value too. You can set it up 
with a keyboard, but attach 
a game controller for a low- 
cost retro games console. Use 
NOOBS to set up a Raspberry 
Pi and make sure you have an 
internet connection (click ‘Wifi 
networks’ to join your network 
during installation). This 
enables you to access a wider 
range of operating systems, 
including Lakka_RPi2. 


@* 


Connect to network 


Connect Lakka to your 
network. Using your gamepad 
(or a keyboard), navigate to 
Settings > WiFi and connect 
to your wireless LAN. Now 
navigate to Settings > Services 
and set SAMBA Enable to On. 


Transfer ROM 

Games are supplied 
separately as ROM files, and 
you must find your own. There 
are many homebrew games 
(modern games developed for 
classic consoles) and one of 
our favourites is Blade Buster, 
developed for NES hardware. 
You can get Blade Buster 
from the developer’s website 
(magpi.cc/bladebuster — it’s in 
Japanese, but click Download). 
The ROM is a zip file (do not 
unzip it). Copy the zip file into 
Network > Lakka > ROMs. 


Get a wireless USB controller like this 
one from The PiHut magpi.cc/gamepad 


MaigPi 


Salta ED >> > 
SC 4885188 


SP 
1HStBBSBeae TKEALTSAIG 


Playing games 

Now go Load Content 
> Start Directory and you 
should see the zip file you 
transferred at the bottom 
(ours is BB_20120301.zip). 
Select the file and choose Load 
Archive and NES / Famicom 
(FCEUmm). The game should 
load. Enjoy shooting the 
baddies in this modern classic 
vertical shoot-’em-up. 


Discover a wealth of retro 
goodness in The MagPi #67. 
magpi.cc/67 
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Mark 
Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 


magpi.cc/YiZnxl 


@mindexplorers 


[ You'll Need 


» Raspbian Jessie 
or newer 


» An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/nBSXKz 


» The latest version 
of Pygame Zero 
(1.2) 


» USB joystick or 
gamepad (optional) 


Code your own 
Pac-Man game 


Pac-Man captured the hearts and pocket money of many young 
people in the eighties. Since then, it has made its way onto just 
about every computer system and console 


Pac-Man eats dots in a maze to score points. 

Avoid the ghosts unless you have just eaten 
a power-up, in which case ghosts are tasty. In this 
series we have gradually introduced new elements 
of Pygame Zero and also concepts around writing 
games. This is the first instalment in a two-part 
tutorial which will show you some more tricks 
to writing arcade games with Pygame Zero. We 
will also use some more advanced programming 
concepts to make our games even better. In this 
first part, we will put together the basics of the 
Pac-Man game and introduce the concept of adding 
extra Python modules to our program. 


T he concept of Pac-Man is quite simple. 


Let’s get stuck in 

As with the more recent episodes of this 
series, let’s jump straight in, assuming that 
we have our basic Pygame Zero setup done. 
Let’s set our window size to WIDTH = 600 and 
HEIGHT = 668. This will give us room for a roughly 
square maze and a header area for some game 
information. We can get our gameplay area set up 
straight away by blitting two graphics — ‘header’ 
and ‘colourmap’ - to @,@ and @, 8@ respectively in 
the draw() function. You can make these graphics 
yourself or you can use ours, which can be found 
at magpi.cc/nBSXKz. 


It's amazing 

The original game had a very specific 
layout to the maze, but many different ones have 
appeared in later versions. The one we will be using 
is very similar to the original, but you can make 
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A Because Pac-Man didn't involve shooting things, 
the Japanese designers thought it would appeal more to girls 


your own design if you want. If you make your own, 
you’ll also have to make two more maps (we’Il 
come to those in a bit) which help with the running 
of the game. The main things about the map is that 
it has a central area where the ghosts start from 
and it doesn’t have any other closed-in areas that 
the ghosts are likely to get trapped in (they can be 
a bit stupid sometimes). 


Hmmm, pizza 

Our next challenge is to get a player actor 
moving around the maze. For some unknown 
reason, the game’s creator, Toru Iwatani, decided 
to make the main character a pizza that ate dots. 
Well, the eighties were a bit strange and that 
seemed perfectly reasonable at the time. We’1l 
need two frames for our character: one with the 
mouth open and one with it closed. We can create 
our player actor near the top of the code using 
player = Actor("pacman_o"). This will create the 
actor with the mouth-open graphic. We will then 
set the actor’s location in an init() function, as in 
previous programs. 
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Modulify to simplify ll at le ty Aig bn Mle Prctotlng ys Nn pita i 


We can get our player onto the play area by a 7 
setting player.x = 29@andplayer.y = 57@in 
the init() function and then call player.draw() 
in the draw() function, but to move the player 
character we’ll need to get some input from the 
player. Previously we have used keyboard and 
mouse input, but this time we are going to have the 
option of joystick or gamepad input. Pygame Zero 
doesn’t currently directly support gamepads, but 
we are going to borrow a bit of the Pygame module 
to get this working. We are also going to makea 
separate Python module for our input. 


ai 


eeeee 


and 


eeeeeeee 


It’s a joystick.init 

Setting up anew module is easy. All we need 
to do is make a new file, in this case gameinput.py, 
and in our main program at the top, write import 
gameinput. In this new file we can import the 
Pygame functions we need with from pygame 
import joystick, key and from pygame.locals eee eee 
import *. We can then initialise the Pygame 
joystick object (this also includes gamepads) by 
typing joystick.init(). We can find out how The masaic nde ot 
many joysticks or gamepads are connected by using Poriicloraancimarencalle 
joystick_count = joystick.get_count(). If we 
find any joysticks connected, we need to initialise 
them individually — see figure1.py. 
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The player is represented 

by the Pac-Man character 
Ghosts move around the that moves around the 
maze, looking for Pac-Man maze, eating dots 


Checking the input 

We can now write a function in our 
gameinput module to check input from 
the player. If we define the function with 
def checkInput(p): we can get the x axis of a 
joystick using joyin. get_axis(@) and the y axis 
by using joyin. get_axis(1). The numbers that 
are returned from these calls will be between -1 
and +1, with o being the central position. We can 
check to see if the values are over 0.8 or under 
-0.8, as, depending on the device, we may not 


figure1.py 


@01. # gameinput Module 

ee2. 

003. from pygame import joystick, key aT 
@04. from pygame.locals import * Top Tip & 
ee5. 

006. joystick.init() 


: : : : : . Modules 

actually see -1 or 1 being returned. You may like to Q07. joystick_count = joystick.get_count() 

test this with your gamepad or joystick to see what 0e8. Using separate 

range of values are returned. @@9. if(joystick_count > @): modules means 
e10. joyin = joystick. Joystick(@) not only is your 
@11. joyin.init() code easier 
@12. # For the purposes of this tutorial ie fallow, But 

07 Up, down, left, or right @13. # we are only going to use the first — 

The variable p that we are passing into our e14. # joystick that is connected. SWorkeor: 


checkInput() function will be the player actor. We 
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figure2.py 


0e1. 
0e2. 
003. 
e004. 
Q@5. 
006. 
007. 
008. 
e0e9. 
10. 
Q11. 
Q12. 
13. 
14. 
Q15. 
016. 
Q17. 
18. 


def checkInput(p): 

global joyin, joystick_count 

xaxis = yaxis = @ 

if joystick_count > 0: 
xaxis = joyin.get_axis(@) 
yaxis = joyin.get_axis(1) 

if key.get_pressed()[K_LEFT] or xaxis < -@.8: 
p.angle = 180 


p.movex = -20 
if key.get_pressed()[K_RIGHT] or xaxis > 0.8: 
p.angle = @ 


p.movex = 20 

if key.get_pressed()[K_UP] or yaxis < -0.8: 
p.angle = 90 
p.movey = -20 

if key.get_pressed()[K_DOWN] or yaxis > 0.8: 
p.angle = 270 
p.movey = 20 


figure3.py 


ee1. 
0e2. 
0e3. 
e004. 
Qe@5. 


006. 
007. 
008. 
ee9. 
18. 
Q11. 
Q12. 
013. 
014. 
15. 
16. 


# inside update() function 


if player.movex or player.movey: 
inputLock() 
animate(player, pos=(player.x + player. 
movex, player.y + player.movey), duration=1/SPEED, 
tween='linear', on_finished=inputUnLock) 


# outside update() function 


def inputLock(): 
global player 
player.inputActive = False 


def inputUnLock(): 
global player 
player.movex = player.movey = @ 
player.inputActive = True 


can test each of the directions of the joystick at the 
same time as the keyboard and then set the player 
angle (so that it points in the correct direction for 
movement) and also how much it needs to move. 
We'll set these by saying (for example, if the left 
arrow is pressed or the joystick is moved to the 

left) if key.get_pressed()[K_LEFT] or xaxis < 
-@.8: and then p.angle = 180 andp.movex = -20. 
See figure2.py for the full checkInput() function. 
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As Sr 


A rae 


YES 


A You can plug a gamepad or joystick into one of the USB ports 
on your Raspberry Pi 


Get a move on! 

Now we have our input function set up, we 
can call it from the update() function. Because this 
function is in a different module, we need to prefix 
it with the module name. In the update() function 
we write gameinput.checkInput (player). After 
this function has been called, if there has been any 
input, we should have some variables set in the 
player actor that we can use to move. We can say 
if player.movex or player.movey: and then use 
the animate() function to move by the amount 
specified in player.movex and player.movey. 


Hold your horses 

The way we have the code at the moment 
means that any time there is some input, we fire 
off a new animation. This will soon mean that 
layers of animation get called over the top of each 
other, but what we want is for the animation to run 
and then start looking for new input. To do this we 
need an input locking system. We can call an input 
lock function before the move and then wait for 
the animation to finish before unlocking to look for 
more input. Look at figure3.py to see how we can 
make this locking system. 


You can't just move anywhere 

Now, here comes the interesting bit. We 
want our player actor to move around the maze, but 
at the moment it will go though the walls and even 
off the screen. We need to restrict the movement 
only to the corridors of the maze. There are several 
different ways we could do this, but for this game 
we’re going to have an image map marking the 


TUTORIAL | MagPt 


figure4.py 


areas that the player actor can move within. The 


map will be a black and white one, showing just the 001. # gamemaps module 
corridors as black and the walls as white. We will 002. from pygame import image, Color 
then look at the map in the direction we want to 003. moveimage = image. load('images/pacmanmovemap.png' ) 
move and see if it is black; if it is, we can move. e0e4. 
@@5. def checkMovePoint(p): 
006. global moveimage 
007. if p.x+p.movex < 0: p.x = p.x+600 
Testing the map ee8. if p.x+p.movex > 600: p.x = p.x-600 
To be able to test the colour of a part of an ee9. if moveimage.get_at((int(p.x+p.movex), int(p.y+p. 
image, we need to borrow a few functions from movey-80))) != Color('black'): 
Pygame again. We’ll also put our map functions e108. p.movex = p.movey = @ 


in a separate module. So make a new Python file 
and call it gamemaps.py and in it we’ll write 
from pygame import image, Color. 

We must also load in our movement map, which : 
we need to do in the Pygame way: moveimage = fi Gg U re5, py 
image. load('images/pacmanmovemap.png'). Then 
all we need to do is write a function to check that 


the direction of the player is valid. See figure4.py 001. def getPlayerImage(): 
for this function. ee2. global player 
ee3. # we need to import datetime at the top of our code 
e004. dt = datetime.now() 
ee5. a = player.angle 
Using the movemap ee6. # this next line will give us a number between 
To use this new module, we need to 007. # @ and 5 depending on the time and SPEED 
import gamemaps at the top of our main code 008. tc = dt.microsecond%(500000/SPEED) /(100000/SPEED) 
file and then, before we animate the player (but ee9. if tc > 2.5 and (player.movex != @ or player.movey 
after we have checked for input), we can call 1=@): 
gamemaps.checkMovePoint (player) ,which will e10. # this is for the closed mouth images 
zero the movex and movey variables of the player e11. if a != 180: 
if the move is not possible. So now we should find e012. player.image = “pacman_c” 
that the player actor can only move inside the 013. else: 
corridors. We do have one special case that you e14. # reverse image if facing left 
may have noticed in figure4.py, and that is because e15. player.image = “pacman_cr” 
there is one corridor where the player can move e16. else: 
from one side of the screen to the other. @17. # this is for the open mouth images 
018. if a != 180: 
e19. player.image = “pacman_o” 
@20. else: 
You spin me round @21. player.image = "“pacman_or" 
There is one more aspect to the movement @22. # set the angle on the player actor 
of the player actor, and that is the animation. 023. player.angle = a 


As Pac-Man moves, the mouth opens and shuts 
and points in the direction of the movement. 
The mouth opening and closing is easy enough: 
we have an image for open and one for closed To Ti a 
and alternate between the two. For pointing in p p 

the correct direction, we can rotate the player 
actor. Unfortunately, this has a slight problem Pygame 
that Pac-Man will be upside-down when moving 
left. So we just need to have one version that is 
switched the other way round. See figure5.py 
for a function that sorts out all of this. 


Pygame Zero is based on Pygame, but if you want 
to use some of the Pygame functions, best to do it 
in a separate module to avoid confusion. 
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figure6.py 


ee1. 
e0e2. 
003. 
e004. 
0e@5. 
006. 
007. 
008. 
ee9. 
18. 
Q11. 


Q12. 
013. 
14. 
15. 
016. 
017. 
18. 
19. 
20. 
Q21. 
Q22. 
Q23. 


24. 
25. 
26. 
Q27. 
28. 
Q29. 
030. 
Q31. 
Q32. 
Q33. 
034. 
Q35. 
036. 
Q37. 


# This goes in the main code file. 


def initDots(): 
global pacDots 
pacDots = [] 
a=x 


(2) 
while x < 30: 


y=0 
while y < 29: 
if gamemaps.checkDotPoint(10+x*20, 10+y*20): 
pacDots.append(Actor(""dot", (10+x*20, 
90+y*20))) 
pacDots[a].status = @ 
at=1 
yt=l 
X t= 1 


# This goes in the gamemaps module file. 
dotimage = image. load('images/pacmandotmap.png' ) 


def checkDotPoint(x,y): 
global dotimage 
if dotimage.get_at((int(x), int(y))) == 
Color('black'): 
return True 
return False 


# This bit goes in the draw() function. 


pacDotsLeft = @ 
for a in range(len(pacDots)): 
if pacDots[a].status == @: 
pacDots[a].draw() 
pacDotsLeft += 1 
if pacDots[a].collidepoint((player.x, player.y)): 
pacDots[a].status = 1 
# if there are no dots left, the player has won 
if pacDotsLeft == @: player.status = 2 


Spot on 

So when we have put in a call to 
getPlayerImage() just before we draw the player 
actor, we should have Pac-Man moving around, 
chomping and pointing in the correct direction. 
Now we need something to chomp. We are going 
to create a set of dots at even spacings along most 
of the corridors. An easy way to do this is to use 
a similar technique that we’re using for testing 
where the corridors are. If we make an image map 
of the places the dots need to go and loop over the 
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whole map, only placing dots where it is black, we 
can get the desired effect. 


Tasty, tasty dots 

To get our dots doing their thing, we’ll need 
to code a few things. We need to initialise actors 
for each dot, we need to draw each dot, and if the 
player eats the dot, we need to stop drawing it; 
figure6.py shows how we can do each of these 
jobs. We need initDots(), we need to add another 
function to gamemaps.py to work out where 
to position the dots, and we need to add some 
drawing code to the draw() function. In addition 
to the code in figure6.py, we need to add a call to 
initDots() in our init() function. 


| ain't afraid of no ghosts 

Now that we have our Pac-Man happily 
munching dots, we must introduce our villains 
to the mix. In the original game, the ghosts had 
names; in the English version they were known as 
Blinky, Pinky, Inky, and Clyde. They roam the maze 
looking for Pac-Man, starting from an enclosure in 
the centre of the map. We can initialise each ghost 
as an actor to appear at the centre of the maze and 
keep them ina list called ghosts[]. To start off 
with, we’ll just make them move around randomly. 
The way we can do this is to set a random direction 
(ghosts[g].dir) for each and then keep them 
moving until they hit a wall. 


17 Random motion 

We can use the same system that we used to 
check player movement for the ghosts. Each time 
we move a ghost — moveGhosts() — we can get a list 
of which directions are available to it. If the current 
direction (ghosts[g].dir) is not available, then we 
randomly pick another direction until we find one 
that we can move in. We can also have a random 
occurrence of changing direction, just to make ita 
bit less predictable - and if the ghosts collide with 
each other, we could do the same. When we have 
moved the ghosts with the animate() function, 
we get it to count how many ghosts have finished 
moving. When they are all done, we can call the 
moveGhosts() function again. 
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gameinput.py 
Top Tip a > Language: Python 3 


Animations 001. # gameinput Module 
ee2. 
When using the animate() function, it is best to use @@3. from pygame import joystick, key 
. a 


the callback function to see when it has finished, as 


j * 
different systems may work at different speeds. BOG, “RON PY Bates ROCA S aners 


ee5. 
006. joystick.init() 
Look like a ghost Q@7. joystick_count = joystick.get_count() 
The last thing to do with our ghosts is to ee8. 
actually draw them to the screen. We can create @69. if(joystick_count > @): 
a function called drawGhosts() where we loop e10. joyin = joystick. Joystick(@) 
through the four ghosts and draw them to the e011. joyin.init() 
screen. One of the details of the original game Q12. 
was that the eyes of the ghosts would follow the @13. def checkInput(p): 
player; we can do this by setting the ghost image e14. global joyin, joystick_count 
to reverse if the player is to the left of the ghost. @15. xaxis = yaxis = @ 
We have numbered images so that ghost one is e16. if joystick_count > @: 
ghost1.png and ghost two is ghost2.png, etc. Have 017. xaxis = joyin.get_axis(@) 
a look at the full pacmant1.py program listing to e18. yaxis = joyin.get_axis(1) 
see all the functions that make the ghosts work. Q19. if key.get_pressed()[K_LEFT] or xaxis < -@.8: 
20. p.angle = 180 
21. p.movex = -20 
@22. if key.get_pressed()[K_RIGHT] or xaxis > 9.8: 
Game over @23. p.angle = @ 
Of course, we need to deal with the end-of- e24. p.movex = 20 
the-game conditions and, as before, we can use @25. if key.get_pressed()[K_UP] or yaxis < -@.8: 
a Status variable. In this case we have previously 026. p.angle = 90 
set player.status = 2 if the player wins. We @27. p.movey = -20 
can check to see if a ghost collides with the player @28. if key.get_pressed()[K_DOWN] or yaxis > 9.8: 
and set player.status = 1. Then we just need to @29. p.angle = 270 
display some text in the draw() function based on 030. p.movey = 20 


this variable. And that’s it for part one. In the next 
part we’ll be giving the ghosts more brains, adding 

3 V_ Three maps are used: one 
levels, lives, and power-ups — and adding some whlehiweseevone tocneek 


sweet, soothing music and sound effects. possible. movements, and 
one to check where dots 


are to be placed 


Colour Map Movement Map Dot Location Map 
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gamemaps.py pacman1.py 


» Language: Python 3 » Language: Python 3 

@01. # gamemaps module 001. import pgzrun 

ee2. 002. import gameinput 

003. from pygame import image, Color 003. import gamemaps 

004. moveimage = image. load(' images/ 004. from random import randint 
pacmanmovemap.png' ) ee@5. from datetime import datetime 

@@5. dotimage = image. load('images/ 006. WIDTH = 680 
pacmandotmap.png' ) 007. HEIGHT = 660 

006. 008. 

@07. def checkMovePoint(p): @@9. player = Actor("pacman_o") # Load in the player Actor image 

008. global moveimage Q10. SPEED = 3 

09. if p.x+p.movex < @: p.x = 011. 
p.x+600 @12. def draw(): # Pygame Zero draw function 

010. if p.x+p.movex > 600: p.x = p.x- 013. global pacDots, player 
600 e14. screen.blit('header', (0, @)) 

e11. if moveimage.get_at((int(p.x+p. @15. screen.blit('colourmap', (@, 80)) 
movex), int(p.y+p.movey-80))) != e16. pacDotsLeft = @ 

Color('black'): Q17. for a in range(len(pacDots)): 

@12. p.movex = p.movey = @ e18. if pacDots[a].status == @: 

@13. e19. pacDots[a].draw() 

@14. def checkDotPoint(x,y): @20. pacDotsLeft += 1 

@15. global dotimage @21. if pacDots[a].collidepoint((player.x, player.y)): 

e16. if dotimage.get_at((int(x), @22. pacDots[a].status = 1 
int(y))) == Color('black'): 23. if pacDotsLeft == @: player.status = 2 

Q17. return True 24. drawGhosts() 

e18. return False @25. getPlayerImage() 

e19. e26. player.draw() 

@20. def getPossibleDirection(g): @27. if player.status == 1: screen.draw.text("GAME OVER" 

@21. global moveimage » center=(300, 434), owidth=0.5, ocolor=(255,255,255), 

@22. if g.x-20 < 0: color=(255,64,0) , fontsize=4@) 

23. g.X = g.x+600 028. if player.status == 2: screen.draw.text("YOU WIN!" 

Q24. if g.x+2@ > 600: » center=(300, 434), owidth=0.5, ocolor=(255,255,255), 

@25. g.xX = g.x-600 color=(255,64,0) , fontsize=4@) 

26. directions = [0,0,0,0] 29. 

@27. if g.x+20 < 600: @30. def update(): # Pygame Zero update function 

028. if moveimage.get_ Q31. global player, moveGhostsFlag, ghosts 
at((int(g.x+20), int(g.y-80))) == @32. if player.status == @: 

Color('black'): directions[@] = 1 33. if moveGhostsFlag == 4: moveGhosts() 

@29. if g.x < 600 and g.x >= @: 34. for g in range(len(ghosts)): 

30. if moveimage.get_ @35. if ghosts[g].collidepoint((player.x, player.y)): 
at((int(g.x), int(g.y-60))) == 36. player.status = 1 
Color(‘black'): directions[1] = 1 037. pass 

Q31. if g.x-20 >= 0: 038. if player.inputActive: 

32. if moveimage.get_ 39. gameinput.checkInput (player) 
at((int(g.x-20), int(g.y-80))) == e040. gamemaps.checkMovePoint(player) 
Color(‘black'): directions[2] = 1 041. if player.movex or player.movey: 

33. if g.x < 600 and g.x >= @: 042. inputLock() 

034. if moveimage.get_ 043. animate(player, pos=(player.x + player.movex, 
at((int(g.x), int(g.y-100))) == player.y + player.movey), duration=1/SPEED, tween='linear’, 
Color('black'): directions[3] = 1 on_finished=inputUnLock) 

@35. return directions 044. 


045. def init(): 
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DOWNLOAD 
THE FULL CODE: 


'y) magpi.cc/jefHFU 


046. 
047. 
048. 
49. 
Q58. 
Q51. 
Q52. 
Q53. 
Q54. 
@55. 
56. 
Q57. 
58. 
Q@59. 


068. 
061. 
062. 
063. 
064. 
Q65. 
066. 
067. 
068. 
69. 
70. 
71. 
72. 
73. 
74. 
Q@75. 
76. 
77. 
078. 
79. 
080. 
081. 
082. 
083. 
084. 
85. 


86. 


087. 
088. 
89. 
90. 
91. 
92. 
93. 


def 


global player 
initDots() 
initGhosts() 
player.x = 290 
player.y = 570 
player.status 
inputUnLock() 


= 0 


getPlayerImage(): 

global player 

dt = datetime.now() 

a = player.angle 

tc = dt.microsecond%(500000/SPEED) /(100000/SPEED) 


!=0): 


def 


def 


if tc > 2.5 and (player.movex != @ or player.movey 
if a != 180: 
player.image = “pacman_c” 
else: 
player.image = “pacman_cr™ 
else: 
if a != 180: 
player.image = “pacman_o” 
else: 
player.image = “pacman_or”™ 


player.angle = a 


drawGhosts(): 
for g in range(len(ghosts)): 
if ghosts[g].x > player.x: 
ghosts[g].image = “ghost"+str(g+1)+"r" 
else: 
ghosts[g].image = 
ghosts[g].draw() 


"ghost"+str(g+1) 


moveGhosts(): 

global moveGhostsFlag 

dmoves = [(1,0),(@,1),(-1,9),(@,-1)] 

moveGhostsFlag = 0 

for g in range(len(ghosts)): 
dirs = gamemaps.getPossibleDirection(ghosts[g]) 
if ghostCollided(ghosts[g],g) and randint(@, 3) 


== @: ghosts[g].dir = 3 


if dirs[ghosts[g].dir] == @ or randint(@,50) == 


d=-1 
while d == -1: 
rd = randint(@,3) 
if dirs[rd] == 1: 
d = rd 
ghosts[g].dir = d 
animate(ghosts[g], pos=(ghosts[g].x 


94. 
95. 
096. 
097. 
098. 
99. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 


114. 
115. 
116. 
117. 
118. 
119. 
120. 
121. 
122. 
123. 
124. 
125. 


126. 
127. 
128. 
129. 
130. 
131. 
132. 
133. 
134. 
135. 
136. 
137. 
138. 
139. 


+ dmoves[ghosts[g].dir][0]*20, ghosts[g].y + 
dmoves[ghosts[g].dir][1]*2@), duration=1/SPEED, 
tween='linear', on_finished=flagMoveGhosts) 


def flagMoveGhosts(): 
global moveGhostsFlag 
moveGhostsFlag += 1 
def ghostCollided(ga,gn): 
for g in range(len(ghosts)): 
if ghosts[g].colliderect(ga) and g != gn: 
return True 
return False 
def initDots(): 
global pacDots 
pacDots = [] 
a=x=0 
while x < 
y=0 
while y < 29: 


30: 


if gamemaps.checkDotPoint(10+x*20, 10+y*20): 


pacDots.append(Actor("dot", (10+x*20, 
90+y*20))) 
pacDots[a].status = @ 
at=1 
yt=l1 
xX += 1 


def initGhosts(): 
global ghosts, moveGhostsFlag 
moveGhostsFlag = 4 


ghosts = [] 
g&= 98 
while g < 4: 


ghosts.append(Actor("ghost"+str(g+1) 

» (270+(g*20), 370))) 
ghosts[g].dir = 
gt=1 


randint(@, 3) 


def inputLock(): 
global player 
player.inputActive = False 


def inputUnLock(): 
global player 
player.movex = player.movey = 0 
player.inputActive = True 


init() 
pgzrun.go() 
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Evans 


PJ Evans is a writer, 
software engineer, 
and Jam organiser. 
His Pi now controls 
more of his house 
than he does. 


mrpjevans.com 


@mrpjevans 


[ You'll Need 


» IKEA Tradfri Colour 
Smart Light 
magpi.cc/zZFhgHN 


> IKEA Tradfri 
Gateway 
magpi.cc/AUqvsQ 


> IKEA KOPPLA 
Edison screw to 
bayonet converter 
(optional) 
magpi.cc/kSMDAC 


Hack smart lights 


On and off? Dimming? We can do better than that. Take control 
of your lights with a Pi and link them to just about anything! 


years now and, in terms of reliability and 

functionality, the technology has come a 
long way. Best of all, the cost of implementation 
has plummeted. Not only are smart lights 
affordable, there’s a great range of products to 
choose from and some are hackable! Using IKEA’s 
Tradfri range, we’ re going to improve our smart 
lighting setup by adding some Pi magic, and then 
linking the lights to the outside world to create a 
bit of Christmas fun. 


GS mart lighting has been around for a few 


Zig-a-Zig(Bee)-Ah 

The Tradfri range uses the popular ZigBee 
radio system to communicate. No central hub is 
needed for basic light switching — you just use the 
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provided remotes. That’s not the case if we want 
to hook things up to a Raspberry Pi or the internet. 
To allow smartphones to control lights, IKEA has 
released an inexpensive gateway that bridges 

the gap between ZigBee and your network. All it 
requires is USB power (charger included) anda 
wired connection to your network. Now, install the 
Tradfri app (iOS and Android) on your phone and 
follow the instructions. 


Lighten up 

As you work through the app’s setup 
procedure, you will be asked if you want to 
configure your devices. You’!I need to plug your 
light in now. All Tradfri lights have Edison screws 
— if you need an adapter for bayonet fittings, IKEA 


sells these too for a princely £1. You’ll also need 
the remote control provided to sync the light up 
with both it and the gateway. It’s a reasonably 
painless process, and by the end you should be able 
to control the light with your phone as well as the 
remote. Don’t proceed until you’ve confirmed this. 


Be prepared 

Once you’ve finished changing the light to 
all the colours of the rainbow, make sure you’ve got 
a Pi ready to go. You’re only going to be working 
on the command line, so Raspbian Stretch Lite is 
perfect. If you’ve got Raspberry Pi Desktop for x86, 
any popular Linux distribution, or even macOS, the 
following instructions will work on these platforms 
too. This is a zero-solder project and we’re not using 
the GPIO this time. All that’s needed is a network 
connection. Just make sure you’ve done sudo apt 
update && sudo apt upgrade before you start. 


We're all going on a gateway hunt 

Before we can talk to the gateway, we need 
to find it, and that means we need its IP address. 
Probably the easiest place to discover it is by 
accessing your router’s webpage, as most routers 
display a list of connected devices. Otherwise, 
Fing, a free app for Android and iOS, scans your 


network and displays the IP address of everything 
it finds. You’re looking for a device with the name 
GW-XXXXXXXXXXXX, where the value of the Xs 
can be seen on the underside of the gateway, under 
‘MAC’. Fing will also display ‘TRADFRI-Gateway’. 


Learning to CoAP 


The Tradfri gateway speaks CoAP, a protocol 
designed for the Internet of Things. It’s lightweight, 


fast, small, and capable of communicating with 
millions of devices. Raspbian does not speak CoAP, 
so we need to teach it. From the command line, 
we’ll download some libraries, compile, and install 
them. Enter the following, line-by-line from your 
home directory: 


sudo apt install git automake libtool 
python3-pip 
git clone --depth 1 --recursive -b dtls 


https://github.com/home-assistant/libcoap. 


git 

cd libcoap 

./autogen.sh 

-/configure --disable-documentation 
--disable-shared --without-debug 
CFLAGS="-D COAP_DEBUG_FD=stderr"™ 

make 

sudo make install 

pip3 install pytradfri 
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4 Here's everything you 


need: a smart light, 
internet gateway, 
remote control, 
and, optionally, 

a socket adapter 


TopTip & 


Don't like 
meatballs? 


There are many 
other hackable 
systems on sale, 
such as Philips 
Hue. If Tradfri 
doesn't meet 
your needs, 
shop around! 
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TopTip & 


Use the GPIO 
for more fun 


Connect any 
number of buttons 
or sensors to your 
GPIO pins and 
have your house 
lights react. 


Open a communications channel 

We've now installed libcoap and pytradfri, 
a Python 3 library for talking CoAP to the 
gateway. This library, written and maintained by 
‘geravlingen’ on GitHub, allows us to talk with 
the various devices easily and without knowing 
anything about the underlying protocols at work. 
It also comes with a testing script, so let’s start 
with that. 


python3 -i -m pytradfri <IP-Address> 


Replace ‘<IP-Address>’ with the address of the 
gateway, as discovered in Step 4. You’ll be asked 
the security code on the base of the gateway, after 
which you’ll see a list of available commands and 
the familiar Python prompt. 


07 It’s time to light the lights 
Let’s test the light. At the Python prompt 
(>>>), type... 


lights 


... followed by ENTER. All being well, a 
description of your light will be displayed as part 
of an array. Seeing this confirms that your Pi is 
talking to the gateway! Now, let’s see if we can 
command our light. Make sure the light is on and 
enter the following at the Python prompt: 


api(light.light_control.set_dimmer(@) ) 
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This instructs all light devices connected 
to the gateway to switch off. Illuminate them 
again with... 


api(light.light_control.set_dimmer (254) ) 


254 is the maximum value for the dimmer. 


Coding light 

Time for some code. When you entered 
your security code in the previous step, a file was 
created called tradfri_standalone_psk.conf. This 
contains your unique password for communicating 
with the gateway. Create all the following scripts in 
the same directory as this file. 

In the script shown here, change the IP address 

to match your gateway and run using Python 3: 


python3 brighten. py 


The code locates the password in the saved file 
and then interrogates the gateway to discover 
available devices. Once we have our lights array, 
a simple loop takes our light from minimum to 
maximum brightness. 


See the light 

We can also monitor the state of Tradfri 
devices, including lights. The pytradfri library 
supports requests on the state of devices, including 
whether they are on or off and their current 
brightness level. A separate thread monitors 
the gateway for changes and keeps our variables 
up to date. 

Download this script: magpi.cc/qDqTXf. Change 
the IP address and run it in the same directory as 
the .conf file. Now watch the output while you 
adjust the brightness using the remote control. As 
the Tradfri range also includes PIR sensors, you’ve 
got the beginnings of a home security system. 


J moments Nouticatons — (Drressages v cheents 


cheerlights 


Top Latest’ «People © Photos, «Videos, «sNews «Broadcasts 


Search filters UteeRe 
@icheerlights, 1S NOE 60 COM herb, give us that orange Teetng Now - Fr Oct 26 
2018 04:38:10 GMT-0500 (COT) 


brighten.py 
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DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


Who to follow.» 
CheerLignts date Mere F 
Fotow The temperature in my OMce is Z0.0C at 9:35am On 20-10-2018 Cheetights 
Blue 
Cheer Cat 
rotew 
Echo: ; 
Deep Purple Tum fchoerlights to 16d on 26 October 2018 08:31:39 
ono CheerLights <r ' 
Tum #cheerlights to blue on 26 October 2018 09:90:33 
Trends for you 
stridayreeing A 2018-10-26 11:15 am ang ChserLights is. 
tocksqaback 
Ute Bike 
@choerlights, 1's not so cold here, give us that pink feeling now - Fri Oct 26 
on pie 2018 04:05:10 GMT-0500 (COT) 
sTEDxBrIghton 
saaiaaal Auto Alerts 
‘The temperature in my office is 19.5C at 9:05am on 26-10-2018 #Cheertights 
Bho 
fFridayReads 


A Connect your lights to the outside world and learn 
about APIs with the fun Cheerlights community 


Some Christmas cheer 

You can link your light to anything you like. 
As it is Christmas, we’re going use Cheerlights 
(cheerlights.com), a service that allows Twitter 
users to set the colour on thousands of light 
devices around the world. It’s also a great way to 
learn about APIs, thanks to its simplistic design. 

Download the code from magpi.cc/ettkzk to 

the same directory as the .conf file from earlier. 
Change the IP address, run the script, and watch 
the light change colour. The code requests the 
current colour from the Cheerlights API at regular 
intervals and sets the light to match. Tweet a 
colour to @cheerlights and change it yourself! 


Let the light flow 

Most actions in home automation come 
down to basic cause and effect: ‘if this happens, 
do this thing’. So it’s no surprise that one of the 


most popular automation services is cal 


ed IFTIT 


(‘If This Then That’). IFTIT supports a huge range 


of internet services and IoT devices, acti 


ngasa 


‘middleware’ to connect things together. Using its 


‘Webhooks’ service, you can trigger any 
actions. A Webhook is a unique URL tha 


of IFTTT’s 
t, when 


called, triggers an action, whether that’s sending 


an email or switching on a coffee machi 


ne. Here’s 


some example code to call an IFTTT Webhook: 


magpi.cc/CSCdNK. 


Going further 


Tradfri plus Raspberry Pi plus IFTTT opens 


up a world of possibilities. Tradfri isn’t j 


ust for 


lighting: there are PIR sensors now available and 


ee1. 
0e2. 
0@3. 
004. 
005. 
006. 
007. 
008. 
ee9. 
10. 
e11. 
Q12. 


Q13. 
e14. 
@15. 
016. 


Q17. 
e18. 


e19. 
20. 
21. 
Q@22. 
23. 
24. 
@25. 
026. 
027. 
028. 


29. 
030. 
31. 


32. 
33. 


© magpi.cc/ntxpZk 
from pytradfri import Gateway 


from pytradfri.api.libcoap_api import APIFactory 
from pytradfri.util import load_json, save_json 
from time import sleep 


# Change this IP address to your gateway 
IP_ADDRESS = '192.168.0.158' 


# Make sure you're in the same directory as this file 
CONFIG_FILE = '‘tradfri_standalone_psk.conf' 


# Load in the file, get our password for the gateway and 
create an API 

conf = load_json(CONFIG_FILE) 

identity = conf[IP_ADDRESS].get(' identity’) 

psk = conf[IP_ADDRESS].get('key') 

api_factory = APIFactory(host=IP_ADDRESS, psk_id=identity, 
psk=psk) 


# This section connects to the gateway and gets information 
on devices 

api = api_factory.request 

gateway = Gateway() 

devices_command = gateway.get_devices() 

devices _commands = api(devices_command) 

devices = api(devices_commands) 


# Create an array of objects that are lights 
lights = [dev for dev in devices if dev.has_light_control] 


# Brightness ranges from @ to 254, so lets set the light in 
stages of 5 
for brightness in range(®, 255, 5): 


# Set the first light to 'brightness' and then pause 

for a moment 
api(lights[0].light_control.set_dimmer(brightness) ) 
sleep(@.1) 


smart sockets are on the way. The lights are also 
available in a range of sizes, perfect for projects 
involving bedside lamps or kitchen lighting. 
Whether you want to make a mood detector, 
ambient lighting system or add home security, 

this is a great low-cost way to start. IKEA is openly 
supporting the community and encouraging people 
to make use of the Tradfri range. Of course, there’s 
plenty of scope for fun and mischief too! 
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Richard 
Smedley 


Having often found 
words better than 
pointing at things, 
Richard stuck with 
the command line 
whence all around 
had fled. 


@RichardSmedley 


Start and stop 
at your command 


Use the command line to start and stop services, 
dnd guto-run them at startup 


Linux distribution - Raspbian included — has 


0 ver the last few years, every major GNU/ 


changed the way that it start 


s up. This means 


that much of the older literature on bookshelves 
and websites, dealing with where to put files 


in rc.local to get them to automati 


cally run on 


startup, is no longer correct — unless you’ve yet to 


upgrade from Raspbian Wheezy. 
One thing remains the same. Al 


/lib/systemd/systemd (still with a 


though the 


irst process the kernel starts is not /sbin/init, but 


PID of 1), it is 


still the parent process of everythi 


ng that happens 


affect how the Pi runs, without 
the code of your Linux kernel! Traditionally, 
GNU/Linux distributions implemented a version 


of the UNIX Syste 


m V init, whic 


having to modify 


h had a well- 


defined startup process with run levels that would 


indicate whether 


the system wa 


user mode’ (rescue mode - a ha 


in when you’ve lo 

headache), conso 

for shutdown. 
Along the way, 


e mode, the G 


files in /etc wi 


s at startup, ‘single 
ndy way to get back 


st your password, or a security 


UI, or heading 


th names 


beginning rco through rcé get called — running 


Vv Backwards 
compatibility with 
init.d scripts - and 
even run levels 
- is maintained 
by systemd 


ile Edit Tabs Help 


pi@raspberr. 


pi@raspberr. 


in user space once the Linux kernel has finished 
initialising devices and drivers, and mounted the 
ile system. 

The init process gets everything else started, 
and usually ends with the prompt inviting you to 
og in to your Pi. Recent versions of Raspbian hide 
most of the messages that this startup process 
generates, but you can see them by typing dmesg. 
They’ re also stored in /var/log/kern.log. 

Startup — init — is the start of user space; this is 
the place where you can put your own programs to 
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startup scripts in /etc/init.d — and /etc/rcS.d, 
which contains files always called at startup, 
regardless of run level. Those /etc/init.d scripts 
can be called directly to start or stop your 
databases, web servers, or anything else that needs 
intervention. Many support further commands 
such as status, to check a service is running 
properly, and reload - the latter is useful if 

you want a service to take a look at fresh config 
settings without doing a full restart. 


sudo /etc/init.d/couchbase-server status 


Although the regular and predictable scripted 
startup of Sys-V init makes it easy to place your 
own programs in the startup process — particularly 
useful on an unattended Pi - the performance of a 
purely sequential startup process is poor, even when 
booting from a solid-state drive. Enter systemd... 


Systemd 

Systemd can start services in parallel, and can 
defer service starts until they are needed. Rather 
than many scripts for individual components, 

a target is set, and systemd resolves the 
dependencies until it reaches that target, 


pi@raspberrypi: /etc/ i picrespberrypi ~ 


File Edit Tabs Help 


pi@raspberr. pi@raspberr 


pi@raspberrypi: ~ 
File Edit Tabs Help 


avoiding any fixed startup sequence along the 
way. Files are found under /etc/systemd/system 
and there’s a lot to learn, but as Raspbian now 
starts up far more quickly, at least we’ve created 
extra time for all that learning. The one thing 

to remember for any user is that systemd and 
its service manager are controlled with the 
systemctl command: 


sudo systemctl restart ssh 


...will restart the SSH server — something you’ ll 
need to do if you change the port it listens on, for 
example. For compatibility, as well as /etc/init.d 
scripts to start and stop services, the system of 
service commands that worked on older versions of 
Raspbian, such as sudo service apache2 reload, 
still works (here we ask a running Apache 2 web 
server to reread its configuration files). 

In /etc/systemd/system/multi-user.target.wants 
you’ll find files like openvpn.service which, when 
examined closely with 1s -1, you’ll see are links 
to files of the same name in /lib/systemd/system 
(other GNU/Linux distributions may place the 
files under /usr/lib). Don’t worry if what’s inside 
these files looks confusing; there’s a logic to them 
with their conditional dependencies, but you can 
safely forget about them until you need to get some 
software working automatically on every system 
restart for your Pi project. Even then, we’ll show 
you another way with crontab — otherwise you’ll 
need to be aware of the following, as those links 
aren’t created manually: 


TUTORIAL | Might 


Following Raspbian Jessie's 
move to systemd, systemct1 
replaces service to restart, or 
query status, of server software 


Adding a service to systemd 
creates a symlink to its real 
location as part of the process - 
don't do it manually 


sudo systemctl enable postgresql.service 

...will create the link, and means PostgreSQL 
will be enabled upon startup. To control the service 
before the next restart: 


sudo systemctl daemon-reload 


... will make systemd aware of the changes. 


Linked In 
Systemd makes links between files automatically, 
but there will be times you’1l want a file to appear 
to be in a local directory when it is elsewhere, with 
a handy little command we have not so far hada 
chance to show you: In. 

In makes a link which allows a file to effectively 
exist in two places at once. In the example: 


In -s /backupdisk/important/essay12.txt 
important-essay.txt 


TopTip & 


...(where /backupdisk/important should be Who / Where 


replaced by the actual path to a directory on your 
backup disk or eleswhere, and essay12.txt by 

the name of a file there) a file will appear in your 
current working directory. But 1s -1 and you’ll 
see that it’s a special type of file, a link pointing 
to the actual file. Edit important-essay.txt and 
you’ll find that essay12.txt on the backup disk will 
be edited. Soft, or ‘symbolic’ links, are created 


Although run 
levels are no 
longer particularly 
meaningful under 
systemd, you can 
still check which 
run level you are 
in with who -r. 
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with the -s switch — you don’t even need the file 
to which you’ re linking to actually exist, which 
makes it handy if linking across a network, or toa 
removable drive. 

It’s called a symbolic link because it works by 
linking to the name of the target file, rather than 
to the file data itself. Create a hard link: 


In /etc/apaches2/apache2. conf 
myapache2. conf 


™m Remove the original file in the hard link 
case, and the link still points to the data @ 


TopTip & 
Systemd dot 


Systemd is a 
complex system, 
with many 
components, from 
systemd.unit 

to systemd.slice 
- but they all 
have their own 
man pages, 

and it’s worth 
reading through 
to help get the 
overall concept. 


A Installing mlocate adds a script 
to /etc/cron.daily to update 
its database of files and folders 


every day 


...and you have two names (and locations) for 
the same file — sounds like the same thing? Not 
exactly: if you delete the original file in the first 
example, you can replace it with a new file of 
the same name, but different contents, and the 
symbolic link will point to the new file. Remove the 
original file in the hard link case, and the link still 
points to the data. 


Location, location 

The startup scripts — whether init.d or systemd 

— are generally for daemons: processes you want 
running all of the time, like web servers and 
databases. There are plenty of programs which do 
housekeeping that need to be run periodically — 
hourly, daily, weekly. For this purpose, the cron 
software utility is ideal for scheduling the running 


54 | magpicc | Start and Stop at your Command 


of such programs and tasks. Cron searches its 
configuration directories and runs through the 
scripts it finds there — have a look at the various 
folders in /etc with names beginning with cron. 

The easiest way to get to know where things like 
this are on your system is to search with locate 
- which is not installed by default on Raspbian. 
Enter apt-get install mlocate, to get the best 
version, then locate cron - which will find you 
every file or directory with cron as its name or as 
part of its name. 

The locate tool maintains a database of every 
file on the system, which itself is updated daily by 
cron. If you’ve made a lot of changes, or want to 
find out where some software you’ ve just installed 
has put its config file, get locate to update its 
database with sudo updatedb. 

The built-in alternative is find, a powerful 
utility which enables you to search particular 
directories — or the whole file system - by name 
or name fragment, size of file, how long ago 
they were modified, or whether they’ re bigger 
than another file. Because it searches the file 
system, rather than a cached listing, it takes 
longer than a locate, but it is always up to date, 
and has search options not found in locate (see 
‘RegExp’ box). To replicate our locate cron 
command with find: 


find / -name '*cron*' 


If you were looking for cron or crontab, but not 
anacron, you could search for 'cron*" instead. 
There will be more output than you want, so pipe 
it through a pager, or perhaps a grep. Back to 
using cron — the easiest way is via crontab, which 
maintains a table where each row specifies a 
command and how often it is to run. You edit the 
crontab file not directly, but with crontab -e, 
which calls up the default text editor to do the job. 
Add an entry in the form: 


45 @5 * * 1-5 calendar | mail -s ‘Your 
calendar' me@myemailaddress.com 


...to take an example from Michael Stutz’s 
Linux Cookbook (No Starch Press); this will grab 
the output from the venerable UNIX calendar 
program and email it to you every morning. The 
first five crontab fields cover minute, hour, day 
of month, month, day of the week, and can all be 
replaced with a single special value, like @daily 
or @hourly. While man crontab tells you a little 
about crontab, man 5 crontab is far more useful 


é > O BBroestenn~ 


Google - Chromium 


: Cannot add dependency job for unit regenerate_ssh_host_keys.service, ignoring: Unit regenerate_ssh_host_keys.service failed to load: No such file or directory. 


as it covers the layout of the file, with examples. 
Run man man for more on the numbered sections 
available with man commands. 

ote that traditional UNIX command-line mail is 
not installed by default on the Pi, so if you wanted 
to follow the example, you’d need to install a simple 
mailer - we recommend ssmtp, and the Raspberry 
Pi forums contain plenty of tips on command-line 
mail, as it can be used in all sorts of projects. 


A fresh startup 

Using the value @reboot, we can easily run our 
own scripts on startup, without messing about 
with system startup scripts. There are times 
when a full systemd startup script will be more 
appropriate, but for quickly getting something 
tested, put the script into crontab. 

There are two things that may catch you out. 
Firstly, you might be running scripts out of a 
directory that you have in your SPATH, which 
defines where Bash looks for commands. As SPATH 
is only set once you log in and your personalised 
-bashre file is read, scripts running from crontab 
which are run immediately upon startup will not be 
aware of your SPATH setting. So, you will need to 
express all commands by their full paths, such as 
/home/pi/bin/test.sh — as well as making sure that 
the permissions are sufficient. 

Secondly, systemd’s parallel service starts also 
mean that some services, such as the network, as 


well as environment variables, may not be ready 
when your @reboot commands are called. If you 
have problems, try giving a short pause first. It’s 
ten seconds in this example crontab entry, but you 
could use the smallest time that consistently works 
on testing: 


@reboot sleep 10; /usr/bin/python3 /home/ 
pi/Documents/Python_Projects/hello_gpio.py 


One of the scripts that you’1l see called by cron 
is to run anacron, designed to periodically run 
tasks on machines that were not always switched 
on — so it is very useful on laptops, too — with tasks 
specified, in anacrontab, to run after so many days 
have passed since they last ran. You can also use 
the automation of crontab or anacron to run your 
own backup scripts. 


Conquer the. 
Command Line 


For more terminal tutorials, take a 
look at our Essentials book, Conquer 
the Command Line. Discover the 
power of the command line to 
simplify complex tasks, or instantly ‘ 
carry out simple ones. I 
magpi.cc/Essentials-Bash 
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20%) 21:15 


<4 dmesg gives you the 
startup messages from 
the kernel - nuggets 
of useful info buried 

in plenty of legacy 

boot information 
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RegExp 


The find tool can 
search by Regular 
Expressions, as 
well as (part) 
name. They're a 
whole book topic 
in themselves, 
but well worth 
investigating 
once you've got 
command-line 
basics under your 
belt, as regexps 
can be used with 
many commands. 
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P1 Bakery: 
The Matrix 


The Matrix is an undedicated array of switches and lights 
that can be put to any number of uses - animated light 
displays, games, controlling synthesizers, and more 


ith the hardware finished, and tested, 
W it is now time to see how we can use it 

with the minimum of user complexity. 
By providing a simple user interface, we can 
begin to explore all the potential of The Matrix, 


without having to worry about the registers in the 
matrix driver. 


Why a class library? 

Last month we published some code to 
get the matrix working. There was a bunch of 
functions you could use to do things like look 
at switches, transfer data into the MAX7219, 
and light LEDs. The aim was just to produce a 
quick and dirty test to try out the hardware and 
spot any wiring faults. The functions were not 
designed to be easy to use and were too close to 
the hardware. With a class library, we can present 
a clean useful interface to the user without them 
needing to know the dirty bits of the hardware. 
This abstraction is known as an API (application 
programming interface). 


The switches 

The latching switches on the lights simply 
connect the multiplexing cathodes in the matrix 
to a GPIO pin. When connected, you get pulses 
on the GPIO pins; when not connected, the pins 
would float, so we arrange for the pins to have the 
internal pull-down resistors enabled. The signals 
we get are shown in Figure 1. This presents a bit 
of a problem for a Linux-based computer such as 
the Raspberry Pi, as these pulses are fast and you 
can’t guarantee to always see them - or indeed, 
as we want, to miss them. So, following advice 
on the Raspberry Pi forums, we turned to the 


pigpio library. 


What is pigpio? 

Pigpio is a GPIO interface, but this one 
has a new feature: a glitch filter. That is, we can 
set it to ignore any small changes in the signal 
level and only report longer-term steady levels. 
This is exactly what we want here. We can set the 


VW Figure 1 Signals received on the GPIO pins 
for switch closed and open 
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Switch Made 


ae 
cme 80uS 


Switch Open 


MaigPi 


Playing the 
Lights Out game 


This row's colours 
will invert 


This column's colours 
will also invert 


glitch filter to ignore the logic low pulses and use [ F D co nt rol 
a callback function when the level changes from a 


one to zero, or zero to one. Both transitions tell us 
a switch has changed, and we can use the callback D co D 2 D1 D 0 
function to set a Boolean flag in a switch list. 


x G 


So what we want to do to read the switches 
is to call a method in our class library which will 
return what switch number has been pressed. If B | ue 
nothing has been pressed since the last time we 
asked the API, then the value -1 is returned. This 
is handled by the getSwitch method of our class 
library. Note that if more than one switch has N ot USE d G reen 
been pressed, this method will only return the 
lowest switch number; if this situation is possible, Red 
the user will need to make successive calls to this 
method until you see a -1 returned. 


The switch API | 


Figure 2 User's 


For any switch the LED control 
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More examples 


We have a few more examples of using this class 
library in the GitHub repo (magpi.cc/1aNqJjmV). 


The LEDs 

Translating the LEDs that need to be on, in 
any one switch, into the register settings in the 
MAX7219 is a bit more complex. This is because 
each register actually controls two switches’ worth 
of LEDs. Figure 2 (previous page) shows how we’d 
like the user to think of the LEDs: a simple 4-bit 
value that’ll set which LEDs are on for each switch. 
The setLed method does this. It is called with the 
switch number, and a number corresponding to the 
required bit pattern. This overwrites any previous 


value, but you might want to add a colour toa 
previous pattern, so the addRed, addGreen, and 
addBlue methods are provided as well. 


More LED methods 

To make things even simpler, we have 
added a few more methods. The setRed, setGreen, 
and setBlue methods just set that LED to be lit in 
a switch, and the clrLEDs turns off all the LEDs on 
the matrix. Also, if you want to find out what LEDs 
are lit on a switch, the getLed method will return 
the colour number bit pattern for an LED, in the 
same format used by the setLed method. Finally, 
the setBrightness method takes a number 
between 0 and 15 to control the brightness. Note 
that a value of zero is not off, but the minimum 
brightness of '/s2 of the maximum brightness. 


. Housekeeping methods 
Re g Isters 07 The two final methods are what we call 

N Add housekeeping methods: those to start up and close 

ome (32 down the class library. The ___init__ function is 
No op oxo called automatically when you make an instance of 

. this class. It is where you set what GPIO pins to use 
Digit 0 Ox! \ for the clock, data, and load pins used to bit-bang 
\ 
ng EM % <4 Fi The MAX721 
igure ie ~ 
\ acl reaater 

Digit 2 0x3 : ‘ 

_ . D7 D6 D506 6 04~—Ss«é#*TDSB D2 D1 DO 
Digit 3 Ox4 

point | a b C d e f g | Segment controls 

Digit 4 Ox5 : 

= / 
Digit 5 Ox6 y, 

=. / 
Digit 6 0x7 / 

/ 
Digit 7 0x8 / 
Decode Ox3 =Onodecode O07 D6 ODS D4 03 D2 ODI ODO __ Intensity control 
ntensity A je ees xX x x x bh i | I, |) Bae sites brightness 
OxF = 31/32 brightness 

Scan Limit OxB = 0 no limit D7 D6 O05 D4 03 D2 OOO 
Shutdown Ox |;--—--—--—-—- X X x X X X X R R=1forrun =0 for stop 
Test OXF 


58 | magpicc | The Matrix 


Red 


Green 


Blue 


Figure 4 


For Switch O 


the MAX7219 multiplexer chip. You also set the 
initial brightness with this call. The cleanUp 
method puts the MAX chip into shutdown so it is 
not multiplexing, and also frees up the callback 
vectors, clears the glitch filter, and stops pigpio 
from running. We recommend calling this method 
before the code terminates. 


More about the MAX721S registers 

Figure 3 shows the register structure 
for the MAX7219 chip. Most of them are 
concerned with the LED segments, which are the 
coloured LEDs in our project. The chip’s data sheet 
(magpi.cc/JPjHhi) tells the full story; Figure 3 
shows a simplified version for our project. We’re 
not using any feature of the scan limit or decode 
functions, so these must be set to zero. The 
intensity control is used to set the brightness, and 
the shutdown for the start/stop function. The scan 
limit register will allow you increase refresh rates if 
you are using fewer than the maximum number of 
digits (8), so we don’t need anything here either. 


Segments to LEDs 

For each digit, there is a segment control 
register, the circuit we used means that each of 
these controls the LEDs for two switches — as 
shown in Figure 4. As you can see, it is nothing 
like the simple API model we used in the methods 
to control the LEDs. The translation from one 
to the other is done in the library code, and so 
this complication is hidden from the user of the 
class library. Registers for digits 0 to 3 control the 
LEDs on switches 0 to 7, and registers digits 4 to 8 
control switches 8 to 15. 


D7 D6 D5) 6D4—OD D2 D1 DO 
pale TS [eae Ss 


Red 
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matrix_demo2.py 


> Language: Python 


0e1. 
0e2. 
0e3. 
004. 
0e@5. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
013. 
e014. 


015. 
016. 
017. 
018. 
019. 
020. 
21. 
022. 
23. 
024. 
25. 
26. 
027. 
028. 
29. 
030. 


Q31. 


import time, os 
os.system("sudo pigpiod") # enable pigpio system 
from max7219bang import Max7219bang 


brightness = 8 
dataPin = 14 ; clockPin = 15 ; loadPin = 18 # matrix wiring 
matrix = Max7219bang(dataPin, clockPin, loadPin, brightness) 


def main(): 
print("Matrix demo - Ctrl C to stop") 
print("Read switches and light up all LEDs on the pushed one") 
matrix.clrLEDs() # turn all LEDs off 
while True: 
pressed = matrix.getSwitch() # return pressed switch or -1 
for none 
if pressed != -1 : # if switch has been pressed 
print("Switch", pressed, "pressed", end=" ") 
if matrix.getLed(pressed) == 0: # if LEDs off 
matrix.setLed(pressed, 7) 
print("lights on") 
else: 
matrix.setLed(pressed, 0) 
print("lights off") 


# turn them on 


# turn them off 


# Main program logic: 
if _ name_ == ' 
try: 
main() 
except: 
matrix.cleanUp() 
# Note the use of the code disables any error output from the 
code 


__main_': 


# when developing code comment out the lines:- try: and except: 
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4 Figure 5 Pressing a switch inverts its column and row 


The class library code 

The code for the ‘max7219bang’ class 
library is shown in the max7219bang.py 
listing; it should be stored in the same folder 
as the programs that use it. You could install it 
permanently into the Python 3 system by altering 
Python’s search path or storing it into a folder 
which is in Python’s path, but we recommend 
that you simply have it in the same folder as 
programs that use it. The first time it is run, a 
__pycache__ directory will be created to save the 
semi-compiled version of the class library. This 
makes it run faster. 


Using the class library 

The code in the matrix_demoz2.py listing 
shows an example of reading the switches, and 
turning on or off all the LEDs on that switch. 
It shows the use of many of the class library 
functions. One important thing to note is that 
you must enable the pigpio system before loading 
the class library. This is only needed once per 
session and could be done from the command 
line, but we include it in the code for simplicity. 
When a Switch is pressed, the state of the LEDs 
is retrieved for that switch, and all the LEDs are 
changed to the opposite state. 


The Lights Out game 

The matrix_lightsOut.py listing is a simple 
Lights Out game. The object is to turn out all the 
LEDs on the matrix board by pressing switches. 
Each switch inverts all the LEDs in the column 
and row of the switch pressed ~ illustrated in 
Figure 5. The game starts out with a set of lights 
that are on and you have to turn them all out with 
two presses. Once you get down to just needing 
one press, it is obvious where you need to press. 
If you press incorrectly, you can always press the 
same switch again and negate the press. Figure 6 
(overleaf) shows a typical puzzle. 


Customising the Lights Out game 

The call to the setup function determines 
the number of key presses you need to complete 
the game. We found going to three was a bit of a 


PIBAKERY | Magri [i 


matrix_lightsOut.py 


» Language: Python 


ee1. 
ee2. 
003. 
e004. 
Q@5. 
006. 


007. 


008. 
ee9. 
10. 
11. 
Q12. 
13. 
14. 
Q15. 
016. 
Q17. 
18. 
19. 
20. 
21. 
Q22. 


23. 


24. 


25. 
26. 
27. 
28. 
Q@29. 
30. 
Q31. 
Q32. 
33. 
34. 
Q@35. 
36. 
37. 
38. 
Q@39. 
048. 
041. 
042. 


import time, os, random 
os.system("sudo pigpiod") # enable pigpio system 
from max7219bang import Max7219bang 


brightness = 8 

dataPin = 14 ; clockPin = 15 ; 
matrix wiring 

matrix = Max7219bang(dataPin, clockPin, 
loadPin, brightness) 

speed = @.2 3; random.seed() 


loadPin = 18 # 


def main(): 
global done 
print("Simple lights out game - Ctrl C to stop") 
print("Press buttons until all lights are out") 
matrix.clrLEDs() # turn all LEDs off 
while True: 
flash(4) 
done = False 
emptyPresses() # remove any bounce 
setup(2) # level of scrambling 
print("Try this one then") 
while not done: 
pressed = matrix.getSwitch() # return 
pressed switch or -1 for 
if pressed != -1 
pressed 


none 
: # if switch has been 


matrix.setLed(pressed, 
matrix.getLed(pressed) “ 7) 

invertRow(pressed) 

invertCol(pressed) 

done = checkOut() 

emptyPresses() # remove any bounce 


def invertRow(switch) : 
row = switch // 4 
for i in range(row*4, row*4+4) : 
matrix.setLed(i,matrix.getLed(i) * 7) 
time.sleep(speed) 


def invertCol(switch) : 
col = switch % 4 
for i in range(col,16,4): 
matrix.setLed(i,matrix.getLed(i) * 7) 
time.sleep(speed) 


def checkOut(): # check LEDs are all off 


043. 
044. 
Q45. 
046. 
Q47. 
048. 
49. 
58. 
@51. 
Q52. 
53. 
54. 
@55. 
Q@56. 


Q@57. 
58. 
Q@59. 
60. 
061. 
062. 
063. 
e064. 
@65. 
066. 
067. 
068. 
69. 


e708. 
e71. 
72. 
073. 
74. 
Q@75. 
076. 
77. 
Q78. 
79. 
80. 


81. 


off = True 
for switch in range(@,16): 
if matrix.getLed(switch) != 0: 
off = False 
return off 


def setup(depth): # inital position of LEDs 
global speed 
speed = 0.001 # make setup quick 
matrix.clrLEDs() # turn all LEDs off 
for i in range(@,depth): 
target = random.randint(@,15) 
#print(target) # uncomment for testing 
matrix.setLed(target, 
matrix.getLed(target) * 7) 
invertRow(target) 
invertCol (target) 
speed = 0.2 # normal display speed 


def flash(times): 
state = 7 
for flash in range(@,times*2): 
for i in range(@,16): 
matrix.setLed(i, state) 
time.sleep(0.3) 
state *= 7 


def emptyPresses(): # remove all bounce from key 
switches 
while matrix.getSwitch() != -1: 
pass 
print("extra bounce") 


# Main program logic: 
if _name_ == ' _ main_': 
try: 
main() 
except: 
matrix.cleanUp() 
# Note the use of the code disables any error 
output from the code 
# when developing code comment out the lines:- try: 
and except: 
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CoderDojo is a global network of free, volunteer-led, 
project-based programming clubs for young people aged 
7-17. Here they can learn to code, build a website, create 
an app or a game, and explore technology in an informal, 
creative, and social environment. 


In order to run locally we need volunteers like you with 
a wide range of skills. You don’t have to be a coder to 
mentor. Dojos benefit from a mix of mentors providing 
support and encouragement to CoderDojo attendees. 
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and is part of the Raspberry Pi Foundation, UK registered charity 1129409 ria Raspberry Pi 


\ 
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max7219bang.py 


i 
s 
3 > Language: Python 
a) 
z 
001. import time 
002. import pigpio 
003. 
@0@4. class Max7219bang(): 
ee5. 
06. def _ init__(self,data,clock, load,bright): 
007. self.da = data 
008. self.ck = clock 
ee9. self.1ld = load 
e109. if bright >-1 and bright < 16: 
@11. self.br = bright 
12. else : 
Q13. self.br = 8 
614. # copy of the Max chip's registers 
& Figure 6 What switch do you have to press Q15. self.registers = [@]*9 
Pode inc igure patictiis e016. #0=off,1=red,2=green,4=blue 
Q17. self.ledsState = [0]*16 # all off 
challenge, but it could be done by trying a key and 018. self.ledcol = [0,4,2,6,1,5,3,7] # LED colour 
seeing if you could solve the problem as presented numbers RGB 
in the original two-press version. If it couldn’t be e19. # colour offset per switch 
done, then you press that key again to undo its e2e. self.colOff = [0,0,0,0, 4,4,4,4, 0,0,0,0, 
action and try another. Taking this to even more 4,4,4,4] 
levels might be too hard unless you leave a trail of @21. # switch number to register address 
breadcrumbs - that is, print out the switches you @22. self.address Sr [25 3)'5575, 2535 So2 5254658) 
have pressed, when you press one. 2,4,6,8] 
e023. self.buttonPins = [12,25,24,23,6,13,19, 26,16, 20, 21,4, 
17,27,22,5] # rows 
e24. self.switches = [False] * 16 
Your turn @25. 
You should now have all the tools you need to @26. self.pi = pigpio.pi() 
write your own programs, so here is the challenge 027. if not self.pi.connected: 
we promised at the start of this project. Writea @28. print("Pi not connected") 
program to display a user-defined sequence of @29. self.pi.set_mode(self.ck, pigpio.OUTPUT) 
lights on the matrix that you can store and load 030. self.pi.set_mode(self.da,pigpio.OUTPUT) 
from a file. You should be able to display the @31. self.pi.set_mode(self.1d, pigpio.OUTPUT) 
sequence at any speed, forwards or backwards, @32. for i in self.buttonPins: 
continuously. We will publish our efforts for this @33. self.pi.set_mode(i, pigpio. INPUT) 
program on our GitHub page in two months; good 034. self.pi.set_pull_up_down(i, pigpio.PUD_DOWN) 
luck with yours. @35. self.pi.write(self.ck, 9) 
036. self.pi.write(self.da, @) 
037. self.pi.write(self.1ld, 1) 
038. 
Start with #73 @39. self.cb = [None] *32 
e4e. for i in range (@, len(self.buttonPins) ): 
This is the latest instalment 041. self.pi.set_glitch_filter(self.buttonPins[i], 200) 
in a series of Mike's Pi Bakery Sera eran # microseconds filter 
tutorials. You can download : ce 042. self.cb[i] = self.pi.callback(self.buttonPins[i], 
digital editions of previous be ee pigpio.EITHER_EDGE, self.cbf) 
tutorials for free. Start with i 043. self.sendMax(@x9,0) # no decode 
BG NEG) 4] 044. self.sendMax(@xB, 7) # scan all digits 
magpi.cc/73 fOP 10 Bay am Y e45. self.sendMax(@xA,self.br) # intensity 
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DOWNLOAD 
THE FULL CODE: 


y) magpi.cce/1NqJjmV 


046. 


Q47. 
048. 
Q@49. 
Q58. 
@51. 
Q@52. 
Q53. 
Q54. 
@55. 
@56. 
Q57. 
Q58. 
@59. 
060. 


061. 
062. 
063. 
064. 
Q65. 
066. 
067. 
068. 
69. 
070. 
Q71. 
Q72. 
073. 
074. 
Q75. 
076. 
077. 
078. 
Q79. 
080. 
081. 
082. 
083. 
084. 
Q85. 
086. 
087. 


088. 
89. 


e908. 
e91. 


mode 


regi 


on f 


out 


data 


self.sendMax(@xC,1) # take out of shutdown 

self.c1lrLEDs() # start with all off 

for i in range(@,16): # clear out any glitches 
self.switches[i] = False 


def setBrightness(self,brightness): 
if brightness > 15: 
brightness = 15 
if brightness < @: 
brightness = @ 
self.br = brightness 
self.sendMax(@xA, self.br) 


def clrLEDs(self): 
for add in range(1,9): 
sters 


# all display 
self.registers[add] = @ 
self.sendMax(add, @) 
for i in range(0,16): 
self.ledsState[i] 


# all display leds 
(2) 


def getLed(self, switch): 


return self.ledCol[self.ledsState[ switch] ] 
def setRed(self, switch): 
self.setLed(switch,1) 
setGreen(self, switch): 
self.setLed(switch, 2) 
setBlue(self, switch): 
self.setLed(switch, 4) 


def 


def 


def addRed(self, switch): 

col = self.getLed(switch) | 1 # add red 
self.setLed(switch, col) 

addGreen(self, switch): 

col = self.getLed(switch) | 2 # add green 
self.setLed(switch, col) 

addBlue(self, switch): 

col = self.getLed(switch) | 4 # add blue 


self.setLed(switch, col) 


def 


def 


def setLed(self,switch,col): # set what LEDs are 
or switch 
if switch > 15 or switch < @ : 
switch = @ #default for switch 
of range 
col &= Qx7 # restrict to @ to 7 
col = self.ledCol[col] #convert to register 


e92. 
93. 
e94. 
@95. 


96. 
097. 


098. 


e99. 
100. 


101. 


102. 


103. 


104. 
105. 
106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 


115. 


116. 
117. 
118. 


119. 
120. 
121. 
122. 
123. 
124. 


125. 


126. 
127. 


128. 
129. 


self.ledsState[switch] = col 
reg = self.address[switch] 
if self.coloff[switch] == @ : 
self.registers[reg] = (self.ledsState[ 
<< 4) | (self.ledsState[switch+4]) 
else: 
self.registers[reg] = (self.ledsState[ 
switch-4] << 4) | (self.ledsState[switch]) 
self.sendMax(self.address[switch], 
self.registers[reg]) 


switch] 


def cbf(self, gpio, level, tick): # call back 

function 

place = [i for i,x in enumerate( 
self.buttonPins) if x == gpio] 

#print("GPIO",gpio, "switch", place[@], 
"steady level", level) 

self.switches[place[@]] = True # indicate 
switch has changed 


def getSwitch(self): 
pressed = -1; i=0 
while pressed == -1 and i<x16: 
if self.switches[i]: # key press found 
self.switches[i] = False 
pressed = i 
it=1 
return pressed 


def sendMax(self,add,data): # send a byte to mux 
chip 
package = (add << 8) | data # join into one 
bit pattern 
self.pi.write(self.1ld, @) # lower load 
for i in range(15,-1,-1): # from 15 to @ 
self.pi.write(self.da, 1 & (package >> i)) 
# send MSB first 
self.pi.write(self.ck, 1) # toggel clock 
self.pi.write(self.ck, 0) 
self.pi.write(self.1ld, 1) # latch value 


def cleanUp(self): 
self.sendMax(@xC,@) # put into shutdown 
mode 
for i in range (@, 16): # remove callback 

vectors 

self.cb[i].cancel() 

self.pi.set_glitch_filter( 
self.buttonPins[i], 2) 


self.pi.stop() # stop pigpio 
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| Raspberry Pi 


Gone too long, the A+ is back with 
the power of the Pi 3 behind it 


new A-form-factor design, more compact 

and lightweight than the full-size B and 
B+ ranges, it was the Raspberry Pi A+ released 
four years ago. Since then, the family has grown 
considerably: we’ve seen the Pi 2, Pi3, Pi Zero, Pi 
Zero W and WH, and most recently the 3B+. 


T he last time the Raspberry Pi family hada 


™ Packing the power of the 
3B+ into the same footprint 
as the original Pi At © 


Now, the Raspberry Pi 3A+ is here, packing the 
power of the 3B+ into the same footprint as the 
original Pi A+. Read on for the lowdown on what 
Eben Upton describes as “the best product we 
can make.” 


UK suppliers: 


@:pinut PIMORONI 
The Pi Hut Pimoroni 
magpi.cc/zVTpyC magpi.cc/LhuKdS 
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RASPBERRY PI 3A+ | Mdghi 


For a complete list of 
ee saned resellers globally where the 
new Raspberry Pi 3 Model 


CPC ModMyPi RS Components A+ can be purchased, 


please see 
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Veet the Raspberry Pi 3A+ 


The 3A+ squeezes a lot into its compact footprint 


SoC: 
Broadcom 
BCM2837Bo 
quad-core A54 
(ARMVv8) 64-bit 
@ 1.4GHz 


V Full-size display (DSI) and 
camera (CSI) ports make 
connecting peripherals a snap 


GPU: 
Broadcom 
VideoCore IV 


NETWORKING: 


2.4GHz and 5GHz A The radio, originally developed 
802.11b/g/n/ac for the 3B+, makes the 3A+ 
wireless LAN the first A-model to feature 
on-board networking 


RAM: 
512MB LPDDR2 
SDRAM 


BLUETOOTH: 
Bluetooth 4.2, 
Bluetooth Low 
Energy (BLE) 


<4 The 3At benefits from 
the same clever power 
management chip (PMIC) 
as the 3B+ 


GPO: 
40-pin GPIO 
header, 
populated 


STORAGE: 
microSD 


rors: | QuickStart guide 


HDMI, 3.5mm 
analogue audio- 
video jack, 
- USB Ee ; The Raspberry Pi 3A+ is directly compatible with 
amera seria 2 ) 
Interface (CSI), the 3B+ and all other Raspberry a models. If you've 
Display Serial already got a power supply and microSD card with 
Interface (DSI) a new version of Raspbian installed (grab the latest A Unlike the Zero family, the 
: é 3A+ includes both full-size 
image from rpf.io/downloads), you’re ready to go. HDMI and analogue audio- 
DIMENSIONS: If the 3A+ is your first Raspberry Pi, see our online Video:outputs 
ByasGeg ni QuickStart guide to get up and running fast. 


magpi.cc/quickstart 
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4 The 3At has the same 
1.4GHz system-on-chip 
(SoC) as the 3B+, with no 
loss of performance 


P The biggest change from 
the 3B+: the reduction from 
four to one USB 2.0 ports 


Raspberry Pi-3 Model Act 
“€c) Raspberry Pi 2018\ 
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Benchmarking 
the Raspberry Pi 3A+ 


or projects where a full- 
= size Pi 3B+ is simply too 
bulky, there hasn’t been 
much choice: aside from the 
Compute Module 3, which is 
targeted at industrial users, the 
choices were the four-year- 
old Pi A+ or ultra-compact Pi 
Zero family — and in either 
case it meant a dramatic drop 
in performance. 
The Pi 3A+ comes with the 
promise of full-size performance 
in a small, lightweight, and less 


power-hungry package, but the 
only way to see if that is true or 
not is to put it through its paces 
in a range of benchmarks. 


Spee comparison 

At its heart, the Pi 3A+ is literally 
a cut-down version of the Pi 

3B+. It has the same Broadcom 
BCM2837Bo system-on-chip 
(SoC) roughly in the centre of 
the board, hidden under a metal 
heat-spreader, which runs at the 


Small but mighty, the reduction 
in size doesnt mean the 3A+ 
costs you any performance 
over its bulkier brother 


same 1.4GHz frequency. While 
512MB of RAM is less than the 
1GB of a Pi 3B+, the smaller 3A+ 
can certainly hold its own. 
Looking back at the original Pi 
A+, it’s hard to imagine they’re 
from the same family: from 
a single-core 32-bit 700MHz 
processor and no networking 
to a quad-core 64-bit 1.4GHz 
processor with built-in wireless 
LAN and Bluetooth, the 3A+ 
should prove a serious upgrade 
for users of its predecessor. 


Python GPIO 


Higher is better 


Designed to highlight a real- 
world bottleneck, the Python 
GPIO benchmark switches a 
single pin on and off while a 
frequency counter measures 
how quickly the pin is toggled. 
The faster a Pi's processor, the 
faster the pin can be toggled 
before the processor hits its limit. 


SysBench CPU 


Lower is better 


Designed to focus on the central 
processor's performance, the 
SysBench CPU benchmark tests 
how quickly a Pi can perform prime 
number calculations. For Pi models 
with quad-core processors, the 
test is run twice: once with a single 
thread using only one of the cores, 
and again with four threads using 


MB FREQUENCY (kHz) 


62.32 


58.55 
43.07 42.63 a575 42.62 
ModelA  ModelB Zero ZeroW Model A+ Model B+ Pi 2 Pi3 Pi 3B+ Pi 3A+ 
343.06 er BBN SINGLE-THREADED (SECS) 
336.91 337.02 
1) Mucti-THREADED (SECS) 
218.53 
139.22 
119.22 119.23 
a 
ModelA Model B Zero ZeroW Model A+ Model B+ Pi3 Pi 3B+ Pi 3A+ 


all four cores. 


70 | magpicc | Raspberry Pi 3A+ 


SysBench 
Memory Throughput 
Higher is better 


Processor performance is only part 
of the puzzle when it comes to 
overall system performance: in the 
SysBench Memory Throughput test, 
measurements are taken to show 
how quickly a Pi can read and write 
to the random-access memory 
(RAM) in 1kB chunks, reported in 
megabytes per second (MBps). 


Power Draw 
Lower is better 


More performance typically means 
more power used, and here each Pi is 
connected to an HDMI display, wireless 
keyboard, and, where applicable, a 
WiFi or wired Ethernet network before 
two measurements are taken: the 
power used, in watts, while the Pi is sat 
idle at the desktop, and again while 
running a CPU-heavy application. 


O 


The Pi 3B+ benefited from 

a change to the way the 
system-on-chip (SoC) is 
attached to the circuit board, 
allowing it to better dissipate 
heat. With the 3A+ having 

a smaller board, this test 
captures thermal images 
under heavy CPU load to 
show how well the two 
designs cope. 


Thermal 
Performance 
Cooler is better 
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By axe READS (MBps) 856.48 


1) ake writes (MBps) 719.76 


638.27 


425.87 


147.27 139.01 
abi 118.14 
105.65 
99.97 
ModelA Model B Zero ZeroW ModelAt+ Model B+ Pi2 Pi 3A+ 
BB) Power DRAW LOAD (Ww) 
I) Power DRAW IDLE () 4.108 
3.672 
2.601 
2.295 
1.428 
1.377 
1.02 1.071 
fea 7 cn = - a 
ModelA Model B Zero ZeroW  ModelAt+ Model B+ Pi2 Pi3 Pi 3B+ Pi 3A+ 
Size & Weight 
Lower is better 
The biggest difference between the Pi 3B+ 
and the 3A+ is their respective sizes. Here, 
the footprint of each Pi model is measured 
from its widest points - to include the size of 
the ports which sit proud of the board - and 
its weight measured, both important aspects 
for embedded and robotics applications. 
1) FootPRINT (mm?) 
BE weicut «) 
lupe shia 5083 5083 5083 5083 50 
42 
39 
3930 
30 
2074 =. 2074 sad 


ModelA Model B Zero ZeroW  ModelA+ Model B+ Pi3 Pi 3B+ Pi 3A+ 
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Eben Upton anc 
Roger Thornton 
onthe PIS At  “WeE==ssss 


we’re dealing with a bunch of subsystems,” Eben 
Upton, co-founder of the Raspberry Pi Foundation, 
explains of the development process that has 


Eben and Roger talk about the Pi 3 A+'s inspiration, delivered the Raspberry Pi 3 Model A+. “Some 


subset of the trains will arrive at the station, and 


launch timing, and hint at the Raspberry Pi 4 when enough of them arrive then we’ve got a new 
product we can make. We don’t have a big team of 

I EOE Oe aes S : marketing guys who make PowerPoints about our 

' F Ne f ; 1 roadmap. It’s much more coffee-table-oriented 

| Simplifying certification | than that.” 


Bringing back the At 

“The A+ form factor was always a good form 

factor,” says Roger Thornton, Principal Hardware 

Engineer. “A lot of people have asked us for an A+ 

again, and we were able to make that, so we did.” 
With both the Raspberry Pi 2 and 3 having 

launched exclusively in larger B-variant form 


“What's the cost to do a certification 
campaign,” Eben asks. “Couple of 
hundred thousand?” 

“For a five-gig one, yeah, it's about 
250... 300 000,” answers Roger - the cost 
of clearing a radio-containing product 


like the Raspberry Pi 3 for general sale. V As with any Raspberry Pi, factors, the A+ has been absent from the line-up 
The Pi 3B+ moved to a modular radio the 34+ undergoes in-depth for a full two generations. “It was skipped for 
testing before it's released oe 
certification, meaning that the existing to the public Raspberry Pi 2 because it simply wasn’t around 


1 
1 
1 
1 
1 
1 
1 
i) 
1 
1 
1 
1 
i) 
1 
i) 
1 
: 
compliance work remains largely valid 
for the 3A+. “A lot of the work we'd done 
i) 

1 

1 

1 

1 

1 

1 

1 

i) 

1 

1 

1 

1 

i) 

1 

1 

1 

1 

1 

1 


to modularise the board meant that we 
could copy over pretty much all of our 
compliance work,” Roger explains, “so 
thankfully this product's been just a bit 
of paperwork. There's definitely been an 
improvement in time-to-market.” 
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for long enough,” recalls Eben. “It normally takes 
six to nine months for us to get our feet under 
ourselves, and by that time it was very clear that 
the 3B was imminent.” 

“The Zero W happened the year after the 3B,” 
Roger adds, “and to some extent addressed the gap 
that an A+ might have occupied.” 

The Zero family isn’t a complete replacement for 
the A+, though, as the launch of the Pi 3B+ earlier 
this year hammered home. 


Miniature size, 
full performance 


“We're confident that the performance you saw 
on a 3B+ you'll be able to get on a 3A+,” says 
Roger. “There's no reduction because of the 
board size change; you should still be able to 
run the processor at the same speed. We have 
had to reduce the memory to hit the price point 
we're after, but it still runs nicely." 

“When we launched the original A+, we 
launched it with half the RAM of the original B+,” 
Eben adds. “At the time that meant 256MB; now 
halving the RAM still leaves you with half a gig, 
which is kind of fun.” 
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4 ‘if we have an 
opportunity to bring 
our best tech down 
a bit, then we do," 
explains Eben Upton 


I “A lot of people have 
asked us for an At 
again, and we were 
able to make that." 
says Roger Thornton 
of the launch 


Filling a hole 
“There’s a massive performance gulf between the 
3B+ and Zero,” explains Eben. “3A+ represents us 
bringing our best technology to the lowest possible 
price point. We can’t bring this technology down 
to the Zero price point, at the moment, but we can 
bring it down a bit. 

“We don’t just like to sit there at $35 feeling 
pleased with ourselves. If we have an opportunity 
to bring our best tech down a bit, then we do. I 


™ This is us bringing our best 
technology to the lowest 
possible price point © 


mean, this is the best product we can make. We 
don’t know how to make anything better at the 
moment. It’s lovely, actually. We like to make 
physically beautiful objects. They sometimes cost a 
bit of money to make, or cost a bit of blood, I think, 
and this... I mean, for me, once we knew we could 
make it, I think we kind of had to. 

“There may be another motivation for doing 
it: it?s kind of tidying up ‘classic’ Raspberry 
Pi,” Eben admits. “We’re not about to launch 
a Raspberry Pi 4, but our attention is turning 
to what might go into a Raspberry Pi 4; we’re 
starting the research phase of figuring out what 
we might do next. Tying up loose ends is an 
important part of that, and the lack of an A+ 
form-factor product is a loose end.” [i 
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DIY Games 
Console 


WOGEMASH 3 SEAPI {OC SHOCA OOZ 


200 pages of 


THE Official 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 4 


Amazing hacking and making projects 
from the makers of MdgPi magazine 


Inside: 
@ How to get involved with the Pi community 
@ The most inspirational community projects 
@ Essential tutorials, guides, and ideas 


@ Expert reviews and buying advice 


Wi le @ 
G9 magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
€ App Store > Google Play 
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MéigPi 


2.15 inches 


128x64 
monochrome 


6 x capacitive 
touch buttons 


Programmable 
in Python 


All 40-pin GPIO 
Pi boards 


All the info you need is 
on the back, although 
you can't see that 
when it's on the Pi 


magpi.cc 


GFX HAT 


Pimoroni 


magpi.cc/ZWvcLG 


£20 / $25 


Rob Zwetsloot looks at a slightly simpler, but much 
more practical, Raspberry Pi display from Pimoroni 


e get asked a lot on The MagPi about 
practical projects — in essence, builds 
that are less experimental party 
pieces, and something you can use day-to-day to 
automate or improve your life in some way. There 
are plenty of fun Raspberry Pi products you can get 
for creating fun stuff, but there are also the lesser- 
known add-ons which can truly help you make a 
more useful project. 
This is the sort of category we see the GFX 
HAT sitting in. That’s definitely not a bad thing, 
though, and if you fancy using it to make a Dalek 
or a tweeting cat flap, we’re definitely not going 
to stop you. However, the functionality of the GFX 


HAT makes it perfect for using it in the kind of 
low-power, headless Raspberry Pi solution that 
takes up little space. 


Useful functionality 
What makes the GFX HAT so good for practical 
projects is that it contains a monochrome, 128*64 
display and six capacitive touch buttons. While 
the display is very simple compared to modern Pi 
display HATs, it does mean it’s easier to program 
custom interfaces, while still having very basic 
options for readable text and number displays. 
The buttons hook straight into Python, allowing 
you to control the Pi and the display. They have 


® Dradbag! Jy Hy Lt bedls Ji del ll lee Le © 
Get started: http://pimoroni.com/gfxhat_. , 


Backlight: $N3218 
Buttons: ‘CAP1 166 


A 2.15” 128x64 gd A 
monochrome LCD. ° 

6 capacitive touch: 
buttons complete. 

with indicator LEDs. 


Le 
‘an rene 


Te iti 
MRO RBASS | 


Made in Sheffield, UK | | 
® http://pimoroni.com 


I?C Addr: 0x54 
2C Addr: 0x2C 


oO 
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REVIEW | Magri Sa 


A. Smalland sleek, much 
like the current range 
of Pimoroni HATs 


‘X t 
some basic symbols on them which . it, you can control the individual 
you can use, or you could just ignore pixels on the screen, the colour 
and relabel them if you really fancy. of the backlight, the backlight on the 
If this all sounds slightly familiar, then - touch buttons, or just input some text for 
you may remember an early Pimoroni product it to display. 


called the Display-O-Tron, which had a few 


buttons and a scrolling display. The GFX HAT is the ' 
evolution of this concept, which we regularly used as) Th e p rO g rammd b | e b q ck | g hts 


at home in practical projects ourselves. really male this something 
Programmable and hackable else as well @ 


As with a lot of Pimoroni products, a custom 
Python library is available for the GFX HAT. With 

It’s not quite as straightforward as GPIO Zero, 
because it’s a fair bit more complex than just . 
lighting an LED; however, with the provided Ve rd I ct 
examples and some testing, you’1l quickly be able 
to figure out how to work it. 

The programmable backlights really make 
this something else as well — to get visual 
feedback from your press on the buttons froma 
UX perspective — and really opens the doors to 


A great upgrade 
over the older 
Display-O-Tron, 
the GFX HAT is 
very customisable 
for use in many 


the kind of projects you could use it for. Simon practical Pi 
game, anyone? projects. 
We also think it works great, with quick 
responses, and a very smart look when you use the 
~~ ia aia right case. Hopefully it will prove useful in your /] ) 
to the pixel density next Raspberry Pi project. Hl 
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» APiZero (or other model) can 
be securely mounted on the 
rear - we love the amusing 


illustrations, too 


Ubercorn 


> Pimoroni » magpi.cc/eebBWo P» £45/S49 


& ASTOUNDING PIXELS GETTING ALL 18 YOUR oni 


GENO ss ae 
r UBERCORN’ f 


While bigger doesn't always mean better, this super-sized display HAT dazzles Phil King 


is even bigger than we anticipated. It 
comes pre-assembled, so you can just plug 
a Pi Zero into the female GPIO header on the rear, 
or use the supplied header extension and metal 
stand-offs to raise the Ubercorn above the USB 
ports on a larger Pi model. 
Since it is essentially a super-sized version 
of the Unicorn HAT HD 16x16 matrix display, 
you can make use of the latter’s Python library 


D warfing the Unicorn HAT HD, the Ubercorn 


WV Measuring 19cm square, the Ubercorn's 
16x16 RGB LED matrix can produce 
impressive visual displays 
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(magpi.cc/EETRAi) to program it, including 
functions to set individual pixels and scroll text. 
Standard RGB LEDs are used, so they can be 
controlled individually, making the Ubercorn 


M The graphical effects look 
much better when diffused, 
increasing the perceived 
size of the pixels @ 


suitable for animations. Several code examples 
are supplied, including a rainbow, graphical 
effects demo, and slideshow of sprite PNGs. 


Blurred lines 
The graphical effects look much better when 
diffused, increasing the perceived size of the 
5mm pixels. While no diffuser is supplied, you can 
make your own with frosted Perspex or even blank 
pieces of white paper. 

As the Ubercorn draws around 1A of current, 
a connected Pi will easily power it. If you want 
to daisy-chain (up to eight) Ubercorns using the 
eight-pin data in/out headers, however, you’ 11 
need to power them via their screw terminals. 

As the current flow is limited by three on-board 
560 Q resistors to avoid overheating, the display 
is a little dim in daylight - particularly when 
diffused — at the default 0.5 brightness, but turn 
it up to max and it’s plenty bright enough. 


DIMENSIONS: 


19x19cm 


PIXELS: 
256 (16x16) 
RGB LEDs 


DRIVER CHIP: 
ARM STM32F 


INTERFACE: 
SPI 


Verdict 


Easy to program, 
the Ubercorn is a 
super-impressive 
large display. 
Potential projects 
include a weather 
display, loT 
dashboard, and 
‘Game Frame’ (see 
magpi.cc/nbHkow 
for an example). 
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CDP Studio is a development platform for industrial control systems, now coming with a free 

version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, l2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStudio 
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3D Xmas Tree 


TYPE: Three-dimensional 
light-up kit 


Although there are a few 


B 
Christmas tree kits available fo 


Raspberry P1 Geueaes ne RapbrySnone ohn 
Christmas gifts Tree Star teonen soley 


TYPE: Pi Zero tree star 


Fill some stockings with m £15/S19 
This Pi Zero HAT is also a star you > magpi.cc/2GewFwe 
these Pi-powered presents can attach to your tree! Upgrading 
your decorations with a Raspberry 
s this issue comes out at the start of Pi is always cool. You'll need to 
A December, hopefully this little list arrives make sure you have a very long USB 
just in time to help you get something for power cable, though. 
the maker in your life. From all of us at The MagPi, ; : 
have a Merry Christmas and a Happy Holiday! > £13/$17 ao SUE Tt it itt 
> magpi.ce/woQGiF emma TT 


Mood Light o/ | 


TYPE: Fun little light project 


swww.buyapica 1) ieximodmypicom 


sah 


This perfect stocking-sized gift 
is part of the excellent range of 
Pimoroni Pi Zero W project kits. 
Keep it by your bed or in your 


Keep your bed orn you Christmas Tree 
ounge and use it to show o' 7 a Solder Kit 


your big moods with this highly 
customisable build. 


oz (tC ® 


TYPE: For makers or programmers 


COG 
E03 
co 


> £30/ $33 


Re) 
RABBERAHH 3 There are two versions of this kit: the 
> magpi.cc/xqySvs tr! ancy 


Ryanteck LTO. 4 one for makers which you just need 
to solder together and run, and the 


version for programmers that you 
1 build and then hack and modify. 
SnowP1 a 
Choices, choices. 
TYPE: The GPIO snowman 


> £6/S8 

We love this classic project kit, so > magpi.cc/efhJHh 
we're more than happy to bring 

it back for this year's Christmas 
guide. It fits on top of a Raspberry 
Pi, and comes as an adorable Little 
kit that’s perfect for practising 

a bit of soldering and coding on 
Christmas Day. 


> £6/S8 
> magpi.cc/2GdupFA 
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InsPiRing 


TYPE: Customisable light arrays 


OctoCam 


TYPE: Stick to the camera 


REVIEW | Magri Sa 


Want to build the ultimate Christmas 
light display? Look no further 

than the RasPiO InsPiRing range 

for creating weird and wonderful 
shapes that are sure to make the 
neighbours jealous. 


> £10/S13 
> rasp.io/inspiring 


The Official 
Raspberry Pi 
Projects Book 
Volume 4 


TYPE: Handy book of projects 


Knowledge is power, and our latest 
Projects Book has 200 pages of 
projects and tutorials to inspire 
and guide you in your journey to 
becoming a maker. It also slots 
nicely into a stocking. 


Pm» £13/S817 
> magpi.cc/projects4 


This cute little kit includes a tiny 
5MP camera. You can stick its 
suckers to any window for a peek 
outside, or - using the supplied 
desk stand - put it on a shelf to 
keep an eye on your all-important 
gifts under the tree. 


> £40/ $43 
> magpi.cc/RqFLZW 


eee a tt tt ee 


YetiBorg v2 


TYPE: The ultimate tiny robot 


" Officiat 


This tiny robot kit can just about 
squeeze into a stocking, and is the 
ultimate little toy to play around 
with on Christmas Day - after some 
adult-supervised building, that is. 
Once you're done playing around 
with it, you can start hacking it to do 
even more. 


> £160/S$218 
> magpi.cc/TADbiy 


Raspberry Pi 
Swag 


TYPE: Stuff for fans 


Pins, bears, mugs, stickers, and 
coasters for the Raspberry Pi fan in 
your life. And the best part is, any 
profits go straight to the Raspberry 
Pi's charitable mission! We 
especially like the enamel badges; 
they're very smart. 


> Various 
> rpf.io/swag 


CHRISTMAS PROJECTS 


Have a Christmas project you’d like to show us? 
Make sure to tag us in social media posts (Twitter 
@TheMagPi and Facebook TheMagPiMagazine) 
and maybe you’! be featured next issue... 
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might 
LEARN TO 


Learn Scratch _ 
with Raspberry P1 


Scratch is the perfect first programming language. 
Sean McManus rounds up some of the best resources 


CODE win: 
SCRATCH 


[ Learn to Code with Scratch 


The MagPi Team 


Price: 
£4 / $5 (free download) 


magpi.cc/ 
learnscratch 


Our own Essentials book brings 
together some of our best 
Scratch articles, with content 
that’s exclusive to this book. 
Chapters are typically three 
or four pages, and each one 
explains a separate project. 
Following an introduction 
to making your first Scratch 
program, there are chapters 
on creating games called 
Bouncy Hedgehog (a catching 


game), Boat Race (a steering 
game), and a multiple-choice 
quiz. Non-game projects 
include a simple chatbot you 
can extend, a poetry generator, 
and LED traffic lights. The 
traffic lights use the Raspberry 
Pi’s GPIO pins and components 
from the CamJam EduKit #1 
(available separately). 

There are two chapters to 
help you customise your own 


Scratch games: one shows you 
how to add a title screen to your 
game to give it a professional 
feel, and the other shows you 
how to add a high-score table 
to keep players coming back 
for more. 

The book builds up toa 
ten-page project to build a3D 
space shooter and concludes 
with a reference guide to the 
Scratch blocks. Hl 


Scratch Books 


Learn Scratch with these books 


Cool Scratch? 3) 
Projects 


COOL SCRATCH PROJECTS 

IN EASY STEPS 

Covering both Scratch 1.4 and Scratch 
2.0, this book includes anaglyph glasses 
for eye-popping 3D effects, music and art 


by Mitchel Resnick, who leads the Scratch 
development team. Includes tips for 
teaching with Scratch. 

> magpi.cc/XkAYXE 


SUPER SCRATCH 

PROGRAMMING ADVENTURE 

A fun comic strip links the nine projects 
in this book, which gradually build your 
Scratch skills. Games include a soccer 


projects, maze games, and a Raspberry Pi 
stop-motion movie creator. 
> magpi.cc/rFxcha 


LIFELONG 

KINDERGARTEN 

Explore the educational philosophy 
behind Scratch’s design with this book 


game, side-scrolling racing game, 


and a combat game. 
> nostarch.com/scratch1 
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ScratchEd 


YouTube 


Lifelong ScratchEd is a community for 1 d 
Kindergarten, teachers and other educators V1 cos 

OHO Interactive using Scratch, created by the 

Sines team behind Scratch itself. At are 603 English resources, so Discover Scratch 
oe the heart of the site isadirectory it’s a great place to go if you’re 1.4 tips and tricks 


magpi.cc/vTfPtH 


of Scratch resources, making it a 
great destination for learners too. 
The resources are organised 
by education level, content type, 
curricular area, and language. 

The curricular areas include 
engineering, maths, music, 
visual arts, and social studies. 
At the time of writing, there 


looking for inspiration, tutorials, 
or lesson plans. 

ScratchEd has a forum too, 
although it is a bit quiet there. 
If you’re looking for help with 
scripts or other issues unrelated 
to teaching, try the much 
busier main Scratch forum first 
(magpi.cc/kucJpY). Hl 


scratch Coding Cards 


Natalie Rusk, 
Lifelong 
Kindergarten 
Group, MIT 


Price: 

£20 / $25 

(free download) 
nostarch.com/ 
scratchcards 


This pack of 75 cards for Scratch 
2.0 is ideal for younger readers 
who might feel overwhelmed 
by a book. The cards break 
some simple projects down into 
easy-to-follow steps. Each card 
contains instructions for adding 
one feature to the program with 
a short script. 

The games included are 
Pong, a catching game, anda 
multiplayer race game. The cards 


go beyond games, though, to 
cover fashion (with a dress-up 
project), music, dance, a virtual 
pet, and storytelling. While 
some projects require readers to 
follow the cards in the correct 
order like a book, others give you 
the freedom to use the cards in 
any order. 

High-quality cards are 
available to buy in a box from 
No Starch, or you can print your 
own (magpi.cc/vkRjlA). 


SCRATCH MINI 
TUTORIALS 

Chris Pautler provides short 
videos on topics such as 
keeping score, keyboard 
inputs, and using text 

the player types in. Well- 
paced, bite-size chunks of 
Scratch goodness. 

> magpi.cc/mmOWUn 
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a 


MAKE A PLATFORM GAME 
This six-minute video walks 
you through creating a 
platform game. It doesn't 

get into level design and 
characters, but it does show 
you how to simulate gravity 
and momentum. 

> magpi.cc/WxzDCa 


MAKE TWO-PLAYER PONG 
Discover how to make a Pong 
game with two paddles, a 
bouncing ball, and a scoring 
system. This twelve-minute 
video is well-explained so you 
can easily follow along. 

> magpi.cc/OkEszB 
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Kids Code Mississippi 
holds regular workshops 
for kids and teachers 


magpi.cc 


Randy Lynn 


Lynn. 


Helping kids learn to code in Mississippi 


Category 
Day job 


first developed an 

interest for computing 

in the 1980s after my 
mother purchased an Apple Ile 
computer for our family,” Randy 
Lynn explains to us. His story 
isn’t too different from all the 
kids that grew up with a BBC 
Micro in the UK. “I learned BASIC 
language programming on that 
computer and had lots of fun 
writing simple programs.” 


Website 
Twitter 


Unlike some other stories, 
Randy’s experience of learning 
programming at college didn’t 
go so well. 

“T quickly realised that I 
was in over my head,” says 
Randy. “I remember one of my 
instructors telling me that my 
code looked like spaghetti due to 
all the unnecessary branching... 
It probably didn’t help that I 
had joined a punk rock band 


and was spending my weekends 
playing gigs instead of studying 
and learning to write better 
code. Eventually, I decided 

to change my major to focus 

on advertising.” 

It wasn’t until 2013 that 
Randy came back to coding, 
introducing his kids to Scratch, 
and reintroducing himself to 
programming. He went on to 
help their school participate 


in Code.org’s Hour of Code 

and, since then, has been a full 
advocate of computer science in 
schools, helping to co-found Kids 
Code Mississippi. 


What is Kids Code Mississippi? 


Kids Code Mississippi is an 
advocacy campaign that I co- 
founded with the president of my 
agency, Tim Mask. We devote our 
time to the initiative pro bono 
because we believe computer 


the steering committee. Most 
recently, I joined Mississippi’s 
board for ECEP (Expanding 
Computing Education Pathways), 
a coalition of states working 
together to broaden participation 
in computing with a focus on 
equity and diversity. 


What is your history with 
the Raspberry Pi? 


I first became familiar with 
Raspberry Pi computers when my 


M A young Mississippian today could 
change the world in a similar way 
[to Elvis] with ag Raspberry Pi @ 


science education is vital to 
modernising our state’s economy 
and making our workforce 

more competitive. 

We've led several hackathons, 
teacher workshops, and 
policymaker forums over the 
past few years. I’ve also set up 
Raspberry Pi stations at events, 
where kids can try out Scratch, 
Sonic Pi, and the Minecraft Pi 
Edition. The kids have a great 
time, and it’s a joy to see their 
eyes light up when taking their 
first steps with coding. 

Pve also remained involved in 
the CS4MS pilot, helping review 
the curriculum and serving on 


son signed up to represent his 
school in a Technology Student 
Association (TSA) competition. 
His team’s idea involved a video 
display, animated characters, 
sound, button switches, and 
LEDs. I ordered a Raspberry Pi 
online, and it was the perfect tool 
for the job and a lot of fun for the 
team to use, too. 

In 2017, I was at a CS education 
conference and happened to 
strike up a conversation with 
Matt Richardson, Raspberry 
Pi’s Executive Director of North 
America, where I learned about 
the Raspberry Pi Foundation’s 
Picademy training. I attended the 
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«~~ Highland Elementary School $ 10, 000.00 
Ten Thousand and 


<x. Hsing an Hourof Code 2013 


wy 
100 Dedeian 


Made Belew 


Lal patie 


A Code.org’s Hour of Code 


KsRandy gives a speech 


Atlanta Picademy in 2018, and 
returned home with lots of ideas 
for holding local events. 


What are your future plans? 


I see Raspberry Pi computers as 
a game-changer for education 
in our state. 

Mississippi has struggled, for 
decades, with issues like poverty 
and poor education outcomes. 
Despite some improvements, 
we still rank as the poorest 
state in the US and have the 
lowest rates of both computer 
ownership and access to 
broadband internet. But, at the 
same time, we Mississippians 
are known for our creativity. 
Where in the past, Mississippians 
like Elvis and Muddy Waters 
picked up a guitar at a young age 
and found inspiration, a young 
Mississippian today could change 
the world in a similar way witha 
Raspberry Pi. 

Raspberry Pi’s low price point 
means school districts can add 
a lot of computing power at a 
very low cost, which is critical 
for those areas where the needs 
are greatest. The computers are 
not only perfect for teaching kids 
how to code, but educators can 
incorporate physical computing 
projects into the curriculum, 
too, thanks to the GPIO pins. 

I believe we are ripe fora 
‘Raspberry Revolution’. 


December: 
Computer 
Education 
Month 


Last year, Kids 
Code Mississippi 
managed to bring 
their campaign to 
the Governor of the 
state, who was able 
to institute December 
(this month!) as 
‘Mississippi Computer 
Science Education 
Month’ You can join 

in wherever you live, 
though. Read more 
about it here: 
magpi.cc/xgqjUR 
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The Raspberry Pi community gets spooky for October 


Ithough this is the December edition of 
The MagPi, due to our schedule, Halloween 
occurred while we were writing this issue. 
Halloween is a great time in the community, 
as folks show off their scary projects and 


A fun skull project we 
got sent on Twitter - 
this one plays a little 


spooky builds Halloween message 
Here are some of the best ones we saw! at the touch of the 

Feel like we overlooked yours? Drop us a line button. Hear what it 

at magpi@raspberrypi.org! has to say at the link.. 


magpi.cc/ZyXwNe 


— 


Halloween has 
become popular 

in the Netherlands, 
according to maker 
Jaap Meihers: “Houses 
where candy is given out 
are decorated. It's not 

a competition (yet), but 
if it were, this year our 
house would have won. 
Using a projector and 


a Raspberry Pi running 


This Pi Zero ‘Scary Halloween Ghost’ has a motion media player OSMC, 
sensor to detect when someone is going by so that we made it Look like 

it can light up and shake and scare them. There are zombies were walking 
also full build instructions for it! around in our house.” 
magpi.cc/WPLGnW magpi.cc/gdAbxa 
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isten up, cadets. We’re pleased 

to tell you that the first phase 

of Mission Space Lab was a 
complete success. Here’s a note from 
Astro Pi command: 

“ESA Education and the Raspberry 
Pi Foundation are delighted to 
announce that Phase 2 of the 
European Astro Pi Challenge: Mission 
Space Lab has begun. During Phase 1, 
we received a record-breaking 471 


Mission Space Lab: Phase One, complete 


Camera Modules, and the Sense 
HAT. You all have until 6 February 
to complete your experiments. 


A new mission 

Well done, cadets! For those who 

missed out, we have a new mission 

for you: Mission Zero. Here’s Astro Pi 

command with further details: 
“Young people up to the age of 

14 still have to the opportunity to 


Young people up to the age of 14 still 
have to the opportunity to take part 


entries from 24 countries! Now, the 
378 selected teams will have the 
chance to write computer programs 
for the scientific experiments 

they want to send to the Astro Pi 
computers aboard the International 
Space Station (ISS).” 

The selected teams will receive 
an European Astro Pi Challenge kit 
so that they can develop and test 
your experiments. The kit includes 
a Raspberry Pi, two Raspberry Pi 


take part in our second challenge, 
Mission Zero. Teams will have until 
20 March 2019 to write a simple 
program to display their personal 
message to the astronauts on 
board. You don’t need any special 
equipment or prior coding skills, 
and all participants that follow the 
guidelines are guaranteed to have 
their programs run in space.” 

Head to the Mission Zero website 
to learn more: magpi.cc/isLMBf. 


PZ 
- 
2 


: 


— 


European Astro Pi Challenge update 
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School HAB 
SUCCeSS 


Reaching the top 50 highest launches 
ee | in the UK, thanks to Skycademy 


HAB launches from schools, but we received an 

email about an incredible launch from Demeter 
House school, an SEN school in North Lincolnshire, 
that managed to break the top 50 highest HAB 
launches in the UK. At the time of writing, they’re 
at 45 (magpi.cc/JkLZJw); however, they were at 43 
when they first made the record of 36542 metres. 

We were lucky enough to get some pictures to 

share of some of the amazing things you see at 
nearly 120000 feet. HI 


| t’s not every day we’re told about successful 


The payload patiently waits 
for the balloon to be inflated 


A casual take-off gives 
us a great view of the 
English countryside 


Rising above the clouds 
is always amazing 


Acrash-landing in a field, 
postflight 


Can you get a more iconic 
image from near-space? 
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Pi Power Board 


et 


Pi PowerBoard 


The Pi PowerBoard is a programmable power board 
for the Raspberry Pi. It includes a real-time clock, 12V 
power input, voltage monitor, and is hackable so you 
can set triggers and timings and such. The creator 
made it as he was looking for a similar power adapter 
for his Pi to be used in a car. Now you can get one too. 


The simple way to mount your Pi! 


kcek.st/2z4LB r ‘ 
et StiZeNER er - Industrial DIN rail mount 


« Open frame for better airflow 
«Integrated USB strain relief 


Wild€ats3D High Resolution 3D Scanner MkII 


1 Hardware|- Raspberry PI|GB+ Based| 
xclusive Points Cloud) Editing & Manipulation 


High resolution 
3D scanner MKII 


This ‘affordable 3D scanner’ is being billed as an 
excellent Pi project, as it runs on a Raspberry Pi 3B+. 
3D scanners can be very expensive, so the sub-£300 
price point is actually pretty good for such a product, 
even if you do have to assemble it yourself. 


kck.st/2pULP2Q 
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aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Bognor Regis Raspberry Jam 


© Saturday 1 December 

9 University of Chichester, Bognor Regis, UK 

> magpi.cc/pVNTsb 

There will be a mix of show-and-tell presentations, along 
with tutorials and chances to tinker with Pi boards. 


02. FSSD Evening of Code 

© Thursday 6 December 

Q Freedom Intermediate School, Franklin, TN, USA 
> magpi.cc/bKFqKz 

The community is welcome to come and see what the 
students of Freedom Intermediate are learning about 
computational thinking. 


03. Christmas Raspberry Jam 

© Saturday 8 December 

9 Worksop College, Worksop, UK 

> magpi.cc/pZkWUP 

This Christmas-themed Raspberry Jam will have 
seasonal projects to see and play with. 


04. Raspberry Pi Jam Session & Code Carnival 
© Saturday 8 December 
9 Third Place Commons, Seattle, WA, USA 


> magpi.cc/sxSbGA 
Join fellow coders, builders, and Raspberry Pi makers 
in an eight-hour, all-day event. 
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05. Leeds Raspberry Jam 


© Wednesday 5 December 

9 Dixons Unity Academy, Leeds, UK 
> magpi.ce/KTqnnj 

Get hands-on with more digital making activities through 
the workshop, and a hackspace area to share projects. 


06. Raspberry Jam @ Pi Towers 

® Saturday 8 December 

Q 37 Hills Road, Cambridge, UK 

> magpi.cc/xpGiso 7 
A family-friendly event where everyone is welcome. FULL CALENDAR 


Coding and digital making activities will be provided Get a full list of upcoming 


for participants. events for December and 
beyond here: 
07. Manchester Raspberry Jam rpf.io/jam 


© Saturday 8 December N , 
Q The Shed, Manchester, UK 

> magpi.cc/EJZNAV 

Attend this monthly Jam to take part in taught workshops 

or to get help working on your own projects. 


08. Yertx Raspberry Jam Colombia 

© Saturday 15 December 

9 Biblioteca Publica Virgilio Barco, Bogota, Colombia 
> magpi.cc/UXPSnm 

Meet others in this Jam to share knowledge 

and your projects based on Raspberry Pi. 
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6 FIND OUT 
ABOUT JAMS 


Want a Raspberry Jam 


in your area? 
Want to start one? 


Email Ben Nuttall about it: 
\ % 8 
jam@raspberrypi.org 
& 


. # 
res) We've highlighted some of the areas & 


in need of a Jam! Can you help out? 


Raspberry Jam advice: 


Post event 


4d | know I'll need some good ideas 
to move beginners on, or they 
won’t return. I know I will have 
to advertise more widely to get the same 
number of people next time. People always ey 7 p 
come in greater numbers to the first of ' 4 /%, ie 
something new.” 


Anne Cahill - York Raspberry Jam 


Every Raspberry Jam is entitled to apply fora 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers and more. 
Get the book here: magpi.cc/2q9DHfQ 
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ss 


Your 
Letters 


With the announcement of the 
brand new Raspberry Pi 3A+ I 
was wondering whether you’d 
be doing anything special like 
putting it on the cover? 

I still use the Pi Zero I got 
with your magazine, and would 
love it if you could do it again! 
I’ll also be able to prepare 
to grab an extra copy before 
everyone rushes to the shops. 


Eve vig email 


The Pi 3A+ is not being given 
away this issue, we’re afraid, 
and we don’t usually announce 
our free give-aways ahead of 
time either. Sorry! 

However, for this month 
only we have a very special 
subscription deal: if you take out 
a12-month subscription to the 
magazine, you’ll get a Raspberry 
Pi 3A+ instead of the Pi Zero W 
bundle! You can find out more 
details about it on page 26. 


Contact us! 


> Twitter §@TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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A Get yourself a Raspberry Pi 
3A* when you subscribe to 
The MagPi for a year! 


Educator discounts 


Hi there, is there any sort 
of discount for schools to 
subscribe, by any chance? 


Dan vic Twitter 


We’re currently in the process 
of creating a new educators 
discount for The MagPi, and 
possibly our sister magazines. 
We had not finalised it before 
we sent this issue to print 

— however, you can email 
rpipresshelp @raspberrypi.org 
and they should be able to help 
you out in some way. 

We’re happy to offer the 
discounted rate to educators, but 
remember that every issue is also 
available as a completely free 
PDF, which might work better in 
some classroom situations! HI 


opuGl 
INT UOete cian 


> Educators should also check out Hello 
World, our sister magazine made 
specifically for teachers: helloworld.cc 


Back issues 


I’m looking to complete my 
collection of back issues of The 
MagPi. Do you have any printed 
copies left of issues 31 onwards? 
I’d happily pay for them, as my 
shelf is looking a little empty! 

If not, when do you expect 
reprints to come in? 


derry via Facebook 


The best place to look for back 
issues is in our official store, 
store.rpipress.cc. Here you 
can find single issues of all 
our magazines. However, once 
they’re sold out, they tend to 
be gone forever. We rarely do 
reprints due to the way the 
magazine industry works. 

Also, issues 31 to 37 were never 
printed. However, with those and 
other issues, please feel free to 
download the PDFs and get them 
printed out for your collection. 
We only ask that you don’t sell 
these printed-out copies, as 
that goes against our Creative 
Commons licence. Hi 


Allavailable 
issues that are 
still in stock can 
be bought from 
our official store: 
store.rpipress.cc 


= 


Raspberry Pi 


PRESS 


I have an almost complete set of The MagPi 
magazines from Christmas 2015 (issue 40) 

to September 2018 (issue 73), plus a 2018 Pi 
Annual. I will send them free to whoever wants 
them, but to one address in one parcel. Please 
email me if you would like them. 


Matthew from the forums 


Thanks for letting us know about this, 
Matthew — you can head to the Raspberry 
Pi forums, where he’s posted his email 
address to take him up on his offer here: 
magpi.cc/UxPzgg. 

We also have a thread on The MagPi forum for 
listing any other magazines or books you might 
want to give away. You can find that thread 
here: magpi.cc/DDeWgi. 


MéigPi 


Please be aware that Matthew will likely 
not have the free gifts from some of our 
previous issues, like the AlY Voice Kit 


We're experts in uncompromising 
sound. HiFiBerry offers a wide 
range of sophisticated solutions 
for high-resolution music playback. 


Build a streaming player, create a 
media center, install a multi-room 
home system, or upcycle your 
favorite vintage speakers, 

there are no limits with our gear. 


What can we help you build today? 


www. hifiberry.com 


[code] 
[club | 


Code Club is a network of volunteers and Sa 
educators who run free coding clubs for 
young people aged 9-13. 


We're always looking for people with coding skills to volunteer to 
run a club at their local school, library, or community centre. 


You can team up with friends or colleagues, you will be supported 
by someone from the venue, and we provide all the materials 
youll need to help children get excited about digital making. 


To find out more, join us at 


Se www.codeclubworld.org 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 es) 
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10 Signed 


Raspberry P1 3A+ 
boards 


To celebrate the release of the brand new 
Raspberry Pi 3A‘, the first new Model A board 
ina while, we've got ten of them to give away, 
complete with ten of the brand new cases! What's 
more, you'll get it signed by Eben Upton. How cool is that? 


Win one of ten 3A+ & cases, signed by Eben himself! 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/3Aplus 


Terms & Conditions 


Competition opens on 29 November 2018 and closes on 20 December 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi 
Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner 
consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: 
participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted 


by email to arrange delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed 
or administered by, or associated with, Instagram or Facebook. 
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ME Magi | THE FINAL WORD 


Surfing the learning curve 


Community Manager Ben Nuttall on removing barriers in digital making 


he email said: “brain-picking, 

T putting out feelers, other yucky 
metaphors.” It arrived in my 
inbox on 8 October 2013. The sender: 
Liz Upton. The three-strong Raspberry 
Pi Foundation wanted to increase their 
staff numbers to four and apparently 
had a Ben Nuttall-shaped hole to fill. 

Pll never forget that moment — I 
was sitting at my desk at my day job 
in Manchester, making website after 
website. It seemed Liz had noticed 
I was quite fond of the Raspberry 
Pi and thought my combination 
of web development skills, and 
experience setting up and running 
the Manchester Raspberry Jam, would 


Technologists programme; I met 

the Prime Minister of Estonia at a 
hackathon; I helped launch the new 
digital maker Scouts badge; I support 
Raspberry Jams worldwide; and I 
recently upgraded our Astro Pi units 
on the International Space Station to 
Raspbian Stretch. 


Skills for life 

Our partnership with The Scout 
Association is very close to my heart 
— I lived through the whole Scouting 
movement from age six to nineteen, 


and it helped me develop skills for life. 


I love the idea that today’s Beavers, 
Cubs, and Scouts will get the chance 


M | love the idea that today's Beavers, Cubs, 
and Scouts will get the chance to include 
digital making in their experience @ 


come in handy at Pi Towers (then, a 
humble single-room office). I jumped 
at the chance, and became a resident 
of Cambridge in November, five years 
ago this month. In my time, I’ve seen 
us launch a dozen or so new hardware 
products, grow to over 100 staff, and 
we’ve just moved into our fourth 
office (where incidentally, I host the Pi 
Towers Raspberry Jam). 

As we’ve grown and developed, so 
has my role. | helped launch Picademy; 
I revamped raspberrypi.org, and our 
first projects site; I ran the Creative 
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to include digital making in their 
Scouting experience, and hope that 
they see the relevance of technology 
in their adventure-filled lives. 

Lots of people and organisations 
in tech talk about making learning 
coding and computing ‘easy’. I don’t 
necessarily think this is the right 
attitude to take. I believe in removing 
barriers to entry and smoothing the 
earning curve, making things more 
accessible, not just easy. GPIO Zero 
aims to make it easier to get started 
with physical computing, and helps 


make the code more approachable 

to read, write, and understand, but 
there’s no end to where you can take 
it - you can do some really advanced 
stuff, and your code is beautifully 
succinct, not a plate of copy-pasted 
spaghetti code you cherry-picked from 
Stack Overflow. A few people have 
asked me recently about how they 
can use GPIO Zero to show and teach 
what’s going on underneath and I’ve 
demonstrated how they can use the 
low-level classes in GPIO Zero to get 
the best of both worlds, which seems 
to have gone down well. 

Another project I created to help 
remove barriers is piwheels, which 
makes pip install fast. The principle 
is simple — we automate compiling all 
Python packages on Raspberry Pi 3s 
(provided by the Mythic Beasts Pi 
Cloud), and provide them for download 
(on a Pi running a web server). 

This Pi currently serves over half a 
million packages per month, which 

in the last twelve months has saved 
Raspberry Pi users a total of 32 years 

of build time - that’s more than my 
lifetime! This project also helped bring 
Google’s machine-learning framework 
TensorFlow to the Raspberry Pi. Hl 


Ben Nuttall 


Raspberry Pi's Community Manager, creator 
of GPIO Zero and piwheels, Jam master, and 
the Foundation's resident Python expert! 


bennuttall.com 
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